Re: BBDB release? [was: Fixing completion cycles]
Release. I've been using v3 for some time and it works very well for me. Bringing more users in will also show /where/ documentation is needed most, once the 10 most FAQ on the list are dealt with, 80% of the documentation effort will already be done. -- Philipp Haselwarter -- Try before you buy = See our experts in action! The most comprehensive online learning library for Microsoft developers is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3, Metro Style Apps, more. Free future releases when you subscribe now! http://p.sf.net/sfu/learndevnow-dev2 ___ bbdb-info@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/bbdb-info BBDB Home Page: http://bbdb.sourceforge.net/
Re: BBDB release? [was: Fixing completion cycles]
On 2012-02-13 07:30 +0800, Roland Winkler wrote: > Previously, other people on this list have voted rather emphatically > for an update of documentation before they wanted to consider > switching from BBDB 2.x to 3. Personally I do not have strong > feelings about the order of steps. I think that by now the code is > sufficiently mature so that from that perspective it can be > released. Potential users of this release (like all current users) > will have to accept that a more coherent doumentation is still > missing. On the other hand, it is probably fair to say that the new > code has already more docstrings for its functions and variables > than the old code. I think some basic documentation is needed and let users know it is work in progress. If you have the basic structure and documentation setup, it will make it easier for users to contribute to portions of it. For example, they might not have time to write the whole thing but can chip in for some sections they care. Some ideas for producing the texinfo file. Write it in a markup language such as markdown or ReST which is readable already even without converting to .info. Then convert to .texinfo. I know .rst has decent support for that - rst2texinfo.py. A more sophisticated documentation tool based on ReST can be found here http://sphinx.pocoo.org/. All documentations written in it are beautiful and it exports to a dozen of formats. Regards, Leo -- Try before you buy = See our experts in action! The most comprehensive online learning library for Microsoft developers is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3, Metro Style Apps, more. Free future releases when you subscribe now! http://p.sf.net/sfu/learndevnow-dev2 ___ bbdb-info@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/bbdb-info BBDB Home Page: http://bbdb.sourceforge.net/
Re: BBDB release? [was: Fixing completion cycles]
On Sun Feb 12 2012 Stefan Monnier wrote: > > my opinion, the biggest problem that needs to be solved before BBDB 3 > > can be released is documentation (a re-write of the info manual). > > That's why so far BBDB 3 is only available from its git repository: > > # git clone git://git.savannah.nongnu.org/bbdb.git > > I think a release without documentation would clarify the situation and > might even bring more contributors to fix the documentation problem, Previously, other people on this list have voted rather emphatically for an update of documentation before they wanted to consider switching from BBDB 2.x to 3. Personally I do not have strong feelings about the order of steps. I think that by now the code is sufficiently mature so that from that perspective it can be released. Potential users of this release (like all current users) will have to accept that a more coherent doumentation is still missing. On the other hand, it is probably fair to say that the new code has already more docstrings for its functions and variables than the old code. Comments from other people on this list are welcome! Roland -- Virtualization & Cloud Management Using Capacity Planning Cloud computing makes use of virtualization - but cloud computing also focuses on allowing computing to be delivered as a service. http://www.accelacomm.com/jaw/sfnl/114/51521223/ ___ bbdb-info@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/bbdb-info BBDB Home Page: http://bbdb.sourceforge.net/
Re: Fixing completion cycles
> my opinion, the biggest problem that needs to be solved before BBDB 3 > can be released is documentation (a re-write of the info manual). > That's why so far BBDB 3 is only available from its git repository: > # git clone git://git.savannah.nongnu.org/bbdb.git I think a release without documentation would clarify the situation and might even bring more contributors to fix the documentation problem, Stefan -- Virtualization & Cloud Management Using Capacity Planning Cloud computing makes use of virtualization - but cloud computing also focuses on allowing computing to be delivered as a service. http://www.accelacomm.com/jaw/sfnl/114/51521223/ ___ bbdb-info@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/bbdb-info BBDB Home Page: http://bbdb.sourceforge.net/
