Re: BP and documentation

2017-11-22 Thread Sijie Guo
I put up a PR for this idea: BP-20: github workflow for bookkeeper proposals. https://github.com/apache/bookkeeper/pull/760 This is my staging website, to show how the bookkeeper proposals would look like there. https://sijie.github.io/bookkeeper-staging-site/community/bookkeeper_proposals/ http

Re: BP and documentation

2017-11-22 Thread Enrico Olivelli
Il mer 22 nov 2017, 10:44 Sijie Guo ha scritto: > On Wed, Nov 22, 2017 at 1:35 AM, Enrico Olivelli > wrote: > > > We could try with the next BP > > Maybe we'd better do the the migration of existing docs only after seeing > > that the approach is feasible. > > My major concern is about non-commi

Re: BP and documentation

2017-11-22 Thread Sijie Guo
On Wed, Nov 22, 2017 at 1:35 AM, Ivan Kelly wrote: > I like it > > +1. > > The BPs can then be used as a basis for documentation, and they can be > held open until all documentation for a feature is done. > yes, exactly > > -Ivan > > On Wed, Nov 22, 2017 at 9:30 AM, Sijie Guo wrote: > > Hi al

Re: BP and documentation

2017-11-22 Thread Sijie Guo
On Wed, Nov 22, 2017 at 1:35 AM, Enrico Olivelli wrote: > We could try with the next BP > Maybe we'd better do the the migration of existing docs only after seeing > that the approach is feasible. > My major concern is about non-committers why non-committers is a concern? Non-committers can sti

Re: BP and documentation

2017-11-22 Thread Ivan Kelly
I like it +1. The BPs can then be used as a basis for documentation, and they can be held open until all documentation for a feature is done. -Ivan On Wed, Nov 22, 2017 at 9:30 AM, Sijie Guo wrote: > Hi all, > > I have been thinking of how to improve documentation process for a while. > We hav

Re: BP and documentation

2017-11-22 Thread Enrico Olivelli
We could try with the next BP Maybe we'd better do the the migration of existing docs only after seeing that the approach is feasible. My major concern is about non-committers. Anyway who proposes a BP will likely be the lead for the implementation, if he is not a committer he would be somehow skil