> This isn’t a good situation at all, we had a usable documentation system in > October and now we have nothing usable, with almost no content and no way to > easily contribute.
how is the content different from the existing one? There wasn't a lot of content and there still isn't. That usable documentation system wasn't used a lot. > We’d agreed that moving to docs to GitHub was an experiment to see if it made > contributing easier but it’s had the opposite effect, we’re in a less usable > state than ever. It seems like we’d be better off going back to our working > SVN documentation and creating a new 2.0 branch from the 1.8 docs and then > updating them. We just haven’t realised the benefit from doing things > differently. There were no major contributions to the documentation using SVN. Everybody could have done it before but didn't. The non existing content is not because of GitHub (or SVN). So my suggestion is to put the content you are planning to contribute into pdfbox-docs. Now if you put it into the CMS fine. We can later make it available in pdfbox-docs. I take some of the blame as I didn't find the time to enhance/restructure the website - again that's not GitHubs fault. Maruan > > -- John > >> On 1 Jan 2015, at 12:52, Maruan Sahyoun <sahy...@fileaffairs.de> wrote: >> >> the docs shall reside in pdfbox-docs from where they will be pulled onto the >> website or looked at directly at github. >> >> The publishing process to our website is not yet in place as there is no new >> content. I'm looking to get the redesign of the website done to accommodate >> for the old 1.8 and new 2.0 release. >> >> Maruan >> >> Am 01.01.2015 um 19:38 schrieb John Hewson <j...@jahewson.com>: >> >>> Hi All, >>> >>> We’re getting closer to 2.0 being ready and I’m thinking about writing some >>> docs, but currently the situation seems to be worse than it was before the >>> docs stated moving to GitHub - where are our canonical docs and how can I >>> contribute to them? >>> >>> All I see on GitHub is some old 1.8 stuff and an incomplete cookbook for >>> forms. Is this content live anywhere? Is there a pay to preview it? >>> >>> -- John >>> >> >
