What “framework” would that be? -- John
> On 2 Jan 2015, at 08:53, Maruan Sahyoun <[email protected]> wrote: > > Hi John, > > I've updated some of the core components of the website mainly the CSS > framework and the page structure to meet the new version of the framework. > > More to come. > > BR > > Maruan > > Am 02.01.2015 um 01:09 schrieb John Hewson <[email protected]>: > >> >>> On 1 Jan 2015, at 14:40, Maruan Sahyoun <[email protected]> wrote: >>> >>> >>>> 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. >> >> Most of the website is missing, all we have is the cookbook. There’s no way >> to build, deploy or preview anything. >> >>> >>>> 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). >> >> If there’s no advantage to using GitHub then we probably shouldn’t use it. >> This was a test to see if there were benefits… but there seem to be none. >> >>> 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’d like to do that, but unless I need to be able to build and deploy the >> docs to the website somehow. >> >>> I take some of the blame as I didn't find the time to enhance/restructure >>> the website - again that's not GitHubs fault. >> >> Enhancements are of course welcome, but we need the old functionality >> working, at a bare minimum. e.g. where has most of the website gone? >> >>> Maruan >>> >>> >>>> >>>> -- John >>>> >>>>> On 1 Jan 2015, at 12:52, Maruan Sahyoun <[email protected]> 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 <[email protected]>: >>>>> >>>>>> 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 >>>>>> >>>>> >>>> >>> >> >
