Great work, Shawn, First of all: Happy New Year. May it be an exciting and interesting one!
It seems to me that having user guides as static pages we create the impression that they are applicable to any version available to the adopters of our products (old, superseded versions and the latest available). We know that that isn't true. As our products evolve, so do our user guides. Would it not be better to recreate the pages in our wiki and per page state to which page they are applicable? Best regards, Pierre Smits ORRTIZ.COM <http://www.orrtiz.com> OFBiz based solutions & services OFBiz Extensions Marketplace http://oem.ofbizci.net/oci-2/ On Sat, Dec 31, 2016 at 7:00 PM, Shawn McKinney <smckin...@apache.org> wrote: > > > On Dec 18, 2016, at 11:54 AM, Emmanuel Lécharny <elecha...@gmail.com> > wrote: > > > > Obviously, there is a lot of thing to add... I think the structure might > > also be improved. Anyway, we have something to start with... > > > > If you feel like to start reviewing the completed pages, please do so ! > > Hello, > > I have completed a first-pass over our LDAP API’s user guide. The goal > was to cleanup grammar, spelling, description semantics, and broken links. > I didn’t add new content, nor did I alter the structure of any of existing > documents. > > There are many sections not yet completed but I believe we’re OK for a 1.0 > GA (although the security sections should be completed soon for obvious > reasons). > > You can review the updated user’s guide here: > http://directory.staging.apache.org/api/user-guide.html > > I really like the story. It should be emphasized once this release > becomes public: > http://directory.staging.apache.org/api/user-guide/1.3- > apache-ldap-api-rational.html > > At the very least we should create a wikipedia page with this as its > history. > > Let me know if you see any errors that need correcting. > > Thanks, > Shawn
