You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@pdfbox.apache.org by Maruan Sahyoun <sa...@fileaffairs.de> on 2013/03/26 14:03:50 UTC
Overhaul PDFBox site
Hi there,
what do you think about giving the PDFBox website an overhaul similar to
http://cloudstack.apache.org/
http://ode.apache.org/index.html
http://cordova.apache.org
with a more prominent user guide such as http://ode.apache.org/userguide/
and a cleaner architecture description (together with main classes) for developers
to support a faster intro into pdfbox
Kind regards
Maruan Sahyoun
Re: Overhaul PDFBox site
Posted by Timo Boehme <ti...@ontochem.com>.
Hi,
moving to the CMS is IMHO a good idea.
To speed up the process of getting consensus here are my
+1
for doing the transition. Thanks Maruan for volunteering for this task.
Best,
Timo
Am 27.03.2013 00:10, schrieb Andreas Lehmkuehler:
> Hi,
>
> Am 26.03.2013 23:04, schrieb Maruan Sahyoun:
>> would be happy to handle that
> Cool! I'll try to help whenever possible.
>
> OK, I guess we don't need a formal vote on moving our site to the CMS, but
> let's wait a couple of days so that everybody has a chance to object.
>
> @Maruan
> Once we have lazy consensus we/you can start with the preparations.
> Please try
> to find out how we should start/proceed. I hope you'll find all you need
> using the pointers I gave in my earlier post
>
>
>> Maruan Sahyoun
>>
>> Am 26.03.2013 um 22:35 schrieb Andreas Lehmkuehler <an...@lehmi.de>:
>>
>>> Hi,
>>>
>>> Am 26.03.2013 17:00, schrieb Maruan Sahyoun:
>>>> well - the navigation is similar also hidden behind drop downs on ode
>>>> compared to cloudstack. Both are using the same css framework [1]
>>>> and the
>>>> navigation can even be combined - that should give us enough freedom
>>>> (and
>>>> is an implementation detail). Both seem to be using the Apache CMS
>>>> [2].
>>> I guess we all know that we have to overhaul the content itself. :-)
>>>
>>> But first of all we have to decide how to manage the content. We have
>>> to use
>>> either svnpubsub or the Apache CMS [1], the latter is recommended. IMHO
>>> we should use the CMS [2] as it would be more flexible and it is
>>> easier to
>>> maintain the content.
>>>
>>> As a good starting point I've changed the maven skin of our site to the
>>> bootstrap like fluendo skin [3]. Maybe it is a good idea to fresh up
>>> the layout
>>> a little bit in preparation of a possible transition to the CMS.
>>>
>>> WDYT and the more interesting question any volunteer to handle the
>>> transition?
>>>
>>> BR
>>> Andreas Lehmkühler
>>>
>>> [1] http://www.apache.org/dev/project-site.html
>>> [2] http://www.apache.org/dev/cmsref.html
>>> [3] http://people.apache.org/~lehmi/pdfbox_fluendo/index.html
>
> BR
> Andreas Lehmkühler
>
--
Timo Boehme
OntoChem GmbH
H.-Damerow-Str. 4
06120 Halle/Saale
T: +49 345 4780474
F: +49 345 4780471
timo.boehme@ontochem.com
_____________________________________________________________________
OntoChem GmbH
Geschäftsführer: Dr. Lutz Weber
Sitz: Halle / Saale
Registergericht: Stendal
Registernummer: HRB 215461
_____________________________________________________________________
Re: Overhaul PDFBox site
Posted by Andreas Lehmkühler <an...@lehmi.de>.
Hi Maruan,
Maruan Sahyoun <sa...@fileaffairs.de> hat am 5. April 2013 um 12:16
geschrieben:
> Hi Andreas,
>
> for the new PDFBox site we need a SVN location
> (http://www.apache.org/dev/cmsref.html#svn).
> As 'site' is already taken would you have a preference? Is 'cmssite' fine?
Just for the record: that's not my decision but ours. :-)
+1, cmssite sounds good to me, please proceed
> BR
>
> Maruan Sahyoun
BR
Andreas Lehmkühler
Re: Overhaul PDFBox site
Posted by Maruan Sahyoun <sa...@fileaffairs.de>.
Hi Andreas,
for the new PDFBox site we need a SVN location (http://www.apache.org/dev/cmsref.html#svn). As 'site' is already taken would you have a preference? Is 'cmssite' fine?
BR
Maruan Sahyoun
Re: Overhaul PDFBox site
Posted by Andreas Lehmkuehler <an...@lehmi.de>.
Hi,
Am 27.03.2013 07:23, schrieb Maruan Sahyoun:
> thx for the offer to help. I think it's needed :-)
I'm happy that someone is eager enough to do some of the not so cool things
like documentation. ;-)
> I already read about the Apache CMS and svnpubsub and think that the CMS is
> the way to go although it's initially a little more effort. One of the major
> benefits of the CMS is that non technical users can use it (the web UI) and
> it's easier for non comitters to contribute [1].
+1, nothing to add here
> As soon as I get a go to move forward I'll open a ticket on Jira to track the
> status of the move. The initial step will be to get myself familiar with the
> tools to build the site as described in [2].
It looks like people gathered a lot of CMS related information so that you
should find everything you need. If some piece is missing try to ask for it
on one of the mentioned mailing lists.
Maybe some of the steps will need PMC-chair power (I saw a form to request the
svn space for the CMS which is limited to chairs) so that I've to step in.
IMHO the following steps have to be done (this list is not exhaustive)
- migrate the existing xdoc files to markdown (maybe there is a script doing
that?)
- create a new content structure following the CMS needs (there is a minimal
example on the cms-wiki-page)
- get in touch with infra to request all the needed things to do the transition
(AFAIU several steps are needed)
> I propose the migration to reuse
> the current content and most of the current navigation and optimize at a later
> stage but making a clearer distinction between users of and developers for
pdfbox.
I'm not sure which way is the best, but I'm sure you'll find out. :-)
> Maruan Sahyoun
>
> [1] http://www.apache.org/dev/cmsref.html#non-committer
> [2] http://www.apache.org/dev/cmsref.html
BR
Andreas Lehmkühler
Re: Overhaul PDFBox site
Posted by Maruan Sahyoun <sa...@fileaffairs.de>.
thx for the offer to help. I think it's needed :-)
I already read about the Apache CMS and svnpubsub and think that the CMS is the way to go although it's initially a little more effort. One of the major benefits of the CMS is that non technical users can use it (the web UI) and it's easier for non comitters to contribute [1].
As soon as I get a go to move forward I'll open a ticket on Jira to track the status of the move. The initial step will be to get myself familiar with the tools to build the site as described in [2]. I propose the migration to reuse the current content and most of the current navigation and optimize at a later stage but making a clearer distinction between users of and developers for pdfbox.
Maruan Sahyoun
[1] http://www.apache.org/dev/cmsref.html#non-committer
[2] http://www.apache.org/dev/cmsref.html
Am 27.03.2013 um 00:10 schrieb Andreas Lehmkuehler <an...@lehmi.de>:
> Hi,
>
> Am 26.03.2013 23:04, schrieb Maruan Sahyoun:
>> would be happy to handle that
> Cool! I'll try to help whenever possible.
>
> OK, I guess we don't need a formal vote on moving our site to the CMS, but
> let's wait a couple of days so that everybody has a chance to object.
>
> @Maruan
> Once we have lazy consensus we/you can start with the preparations. Please try
> to find out how we should start/proceed. I hope you'll find all you need
> using the pointers I gave in my earlier post
>
>
>> Maruan Sahyoun
>>
>> Am 26.03.2013 um 22:35 schrieb Andreas Lehmkuehler <an...@lehmi.de>:
>>
>>> Hi,
>>>
>>> Am 26.03.2013 17:00, schrieb Maruan Sahyoun:
>>>> well - the navigation is similar also hidden behind drop downs on ode
>>>> compared to cloudstack. Both are using the same css framework [1] and the
>>>> navigation can even be combined - that should give us enough freedom (and
>>>> is an implementation detail). Both seem to be using the Apache CMS [2].
>>> I guess we all know that we have to overhaul the content itself. :-)
>>>
>>> But first of all we have to decide how to manage the content. We have to use
>>> either svnpubsub or the Apache CMS [1], the latter is recommended. IMHO
>>> we should use the CMS [2] as it would be more flexible and it is easier to
>>> maintain the content.
>>>
>>> As a good starting point I've changed the maven skin of our site to the
>>> bootstrap like fluendo skin [3]. Maybe it is a good idea to fresh up the layout
>>> a little bit in preparation of a possible transition to the CMS.
>>>
>>> WDYT and the more interesting question any volunteer to handle the transition?
>>>
>>> BR
>>> Andreas Lehmkühler
>>>
>>> [1] http://www.apache.org/dev/project-site.html
>>> [2] http://www.apache.org/dev/cmsref.html
>>> [3] http://people.apache.org/~lehmi/pdfbox_fluendo/index.html
>
> BR
> Andreas Lehmkühler
>
Re: Overhaul PDFBox site
Posted by Andreas Lehmkuehler <an...@lehmi.de>.
Hi,
Am 26.03.2013 23:04, schrieb Maruan Sahyoun:
> would be happy to handle that
Cool! I'll try to help whenever possible.
OK, I guess we don't need a formal vote on moving our site to the CMS, but
let's wait a couple of days so that everybody has a chance to object.
@Maruan
Once we have lazy consensus we/you can start with the preparations. Please try
to find out how we should start/proceed. I hope you'll find all you need
using the pointers I gave in my earlier post
> Maruan Sahyoun
>
> Am 26.03.2013 um 22:35 schrieb Andreas Lehmkuehler <an...@lehmi.de>:
>
>> Hi,
>>
>> Am 26.03.2013 17:00, schrieb Maruan Sahyoun:
>>> well - the navigation is similar also hidden behind drop downs on ode
>>> compared to cloudstack. Both are using the same css framework [1] and the
>>> navigation can even be combined - that should give us enough freedom (and
>>> is an implementation detail). Both seem to be using the Apache CMS [2].
>> I guess we all know that we have to overhaul the content itself. :-)
>>
>> But first of all we have to decide how to manage the content. We have to use
>> either svnpubsub or the Apache CMS [1], the latter is recommended. IMHO
>> we should use the CMS [2] as it would be more flexible and it is easier to
>> maintain the content.
>>
>> As a good starting point I've changed the maven skin of our site to the
>> bootstrap like fluendo skin [3]. Maybe it is a good idea to fresh up the layout
>> a little bit in preparation of a possible transition to the CMS.
>>
>> WDYT and the more interesting question any volunteer to handle the transition?
>>
>> BR
>> Andreas Lehmkühler
>>
>> [1] http://www.apache.org/dev/project-site.html
>> [2] http://www.apache.org/dev/cmsref.html
>> [3] http://people.apache.org/~lehmi/pdfbox_fluendo/index.html
BR
Andreas Lehmkühler
Re: Overhaul PDFBox site
Posted by Maruan Sahyoun <sa...@fileaffairs.de>.
would be happy to handle that
Maruan Sahyoun
Am 26.03.2013 um 22:35 schrieb Andreas Lehmkuehler <an...@lehmi.de>:
> Hi,
>
> Am 26.03.2013 17:00, schrieb Maruan Sahyoun:
>> well - the navigation is similar also hidden behind drop downs on ode
> > compared to cloudstack. Both are using the same css framework [1] and the
> > navigation can even be combined - that should give us enough freedom (and
> > is an implementation detail). Both seem to be using the Apache CMS [2].
> I guess we all know that we have to overhaul the content itself. :-)
>
> But first of all we have to decide how to manage the content. We have to use
> either svnpubsub or the Apache CMS [1], the latter is recommended. IMHO
> we should use the CMS [2] as it would be more flexible and it is easier to
> maintain the content.
>
> As a good starting point I've changed the maven skin of our site to the
> bootstrap like fluendo skin [3]. Maybe it is a good idea to fresh up the layout
> a little bit in preparation of a possible transition to the CMS.
>
> WDYT and the more interesting question any volunteer to handle the transition?
>
> BR
> Andreas Lehmkühler
>
> [1] http://www.apache.org/dev/project-site.html
> [2] http://www.apache.org/dev/cmsref.html
> [3] http://people.apache.org/~lehmi/pdfbox_fluendo/index.html
>
>> Maruan Sahyoun
>>
>> [1] http://twitter.github.com/bootstrap/
>> [2] https://svn.apache.org/repos/infra/websites/cms/webgui/content/export.json
>>
>> Am 26.03.2013 um 15:22 schrieb Timo Boehme <ti...@ontochem.com>:
>>
>>> Hi,
>>>
>>> an update to the website with a cleaner grouping of content etc. would help to attract people. While 'ode' and 'cordova' are visually nice I would like to keep more navigation possibilities at the start page like in 'cloudstack'.
>>>
>>>
>>> Best regards,
>>> Timo
>>>
>>>
>>> Am 26.03.2013 14:03, schrieb Maruan Sahyoun:
>>>> Hi there,
>>>>
>>>> what do you think about giving the PDFBox website an overhaul similar to
>>>>
>>>> http://cloudstack.apache.org/
>>>> http://ode.apache.org/index.html
>>>> http://cordova.apache.org
>>>>
>>>> with a more prominent user guide such as http://ode.apache.org/userguide/
>>>> and a cleaner architecture description (together with main classes) for developers
>>>>
>>>> to support a faster intro into pdfbox
>>>>
>>>> Kind regards
>>>>
>>>> Maruan Sahyoun
>>>
>>>
>>> --
>>>
>>> Timo Boehme
>>> OntoChem GmbH
>>> H.-Damerow-Str. 4
>>> 06120 Halle/Saale
>>> T: +49 345 4780474
>>> F: +49 345 4780471
>>> timo.boehme@ontochem.com
>>>
>>> _____________________________________________________________________
>>>
>>> OntoChem GmbH
>>> Geschäftsführer: Dr. Lutz Weber
>>> Sitz: Halle / Saale
>>> Registergericht: Stendal
>>> Registernummer: HRB 215461
>>> _____________________________________________________________________
>
Re: Overhaul PDFBox site
Posted by Andreas Lehmkuehler <an...@lehmi.de>.
Hi,
Am 26.03.2013 17:00, schrieb Maruan Sahyoun:
> well - the navigation is similar also hidden behind drop downs on ode
> compared to cloudstack. Both are using the same css framework [1] and the
> navigation can even be combined - that should give us enough freedom (and
> is an implementation detail). Both seem to be using the Apache CMS [2].
I guess we all know that we have to overhaul the content itself. :-)
But first of all we have to decide how to manage the content. We have to use
either svnpubsub or the Apache CMS [1], the latter is recommended. IMHO
we should use the CMS [2] as it would be more flexible and it is easier to
maintain the content.
As a good starting point I've changed the maven skin of our site to the
bootstrap like fluendo skin [3]. Maybe it is a good idea to fresh up the layout
a little bit in preparation of a possible transition to the CMS.
WDYT and the more interesting question any volunteer to handle the transition?
BR
Andreas Lehmkühler
[1] http://www.apache.org/dev/project-site.html
[2] http://www.apache.org/dev/cmsref.html
[3] http://people.apache.org/~lehmi/pdfbox_fluendo/index.html
> Maruan Sahyoun
>
> [1] http://twitter.github.com/bootstrap/
> [2] https://svn.apache.org/repos/infra/websites/cms/webgui/content/export.json
>
> Am 26.03.2013 um 15:22 schrieb Timo Boehme <ti...@ontochem.com>:
>
>> Hi,
>>
>> an update to the website with a cleaner grouping of content etc. would help to attract people. While 'ode' and 'cordova' are visually nice I would like to keep more navigation possibilities at the start page like in 'cloudstack'.
>>
>>
>> Best regards,
>> Timo
>>
>>
>> Am 26.03.2013 14:03, schrieb Maruan Sahyoun:
>>> Hi there,
>>>
>>> what do you think about giving the PDFBox website an overhaul similar to
>>>
>>> http://cloudstack.apache.org/
>>> http://ode.apache.org/index.html
>>> http://cordova.apache.org
>>>
>>> with a more prominent user guide such as http://ode.apache.org/userguide/
>>> and a cleaner architecture description (together with main classes) for developers
>>>
>>> to support a faster intro into pdfbox
>>>
>>> Kind regards
>>>
>>> Maruan Sahyoun
>>>
>>
>>
>> --
>>
>> Timo Boehme
>> OntoChem GmbH
>> H.-Damerow-Str. 4
>> 06120 Halle/Saale
>> T: +49 345 4780474
>> F: +49 345 4780471
>> timo.boehme@ontochem.com
>>
>> _____________________________________________________________________
>>
>> OntoChem GmbH
>> Geschäftsführer: Dr. Lutz Weber
>> Sitz: Halle / Saale
>> Registergericht: Stendal
>> Registernummer: HRB 215461
>> _____________________________________________________________________
>>
>
>
Re: Overhaul PDFBox site
Posted by Maruan Sahyoun <sa...@fileaffairs.de>.
well - the navigation is similar also hidden behind drop downs on ode compared to cloudstack. Both are using the same css framework [1] and the navigation can even be combined - that should give us enough freedom (and is an implementation detail). Both seem to be using the Apache CMS [2].
Maruan Sahyoun
[1] http://twitter.github.com/bootstrap/
[2] https://svn.apache.org/repos/infra/websites/cms/webgui/content/export.json
Am 26.03.2013 um 15:22 schrieb Timo Boehme <ti...@ontochem.com>:
> Hi,
>
> an update to the website with a cleaner grouping of content etc. would help to attract people. While 'ode' and 'cordova' are visually nice I would like to keep more navigation possibilities at the start page like in 'cloudstack'.
>
>
> Best regards,
> Timo
>
>
> Am 26.03.2013 14:03, schrieb Maruan Sahyoun:
>> Hi there,
>>
>> what do you think about giving the PDFBox website an overhaul similar to
>>
>> http://cloudstack.apache.org/
>> http://ode.apache.org/index.html
>> http://cordova.apache.org
>>
>> with a more prominent user guide such as http://ode.apache.org/userguide/
>> and a cleaner architecture description (together with main classes) for developers
>>
>> to support a faster intro into pdfbox
>>
>> Kind regards
>>
>> Maruan Sahyoun
>>
>
>
> --
>
> Timo Boehme
> OntoChem GmbH
> H.-Damerow-Str. 4
> 06120 Halle/Saale
> T: +49 345 4780474
> F: +49 345 4780471
> timo.boehme@ontochem.com
>
> _____________________________________________________________________
>
> OntoChem GmbH
> Geschäftsführer: Dr. Lutz Weber
> Sitz: Halle / Saale
> Registergericht: Stendal
> Registernummer: HRB 215461
> _____________________________________________________________________
>
Re: Overhaul PDFBox site
Posted by Timo Boehme <ti...@ontochem.com>.
Hi,
an update to the website with a cleaner grouping of content etc. would
help to attract people. While 'ode' and 'cordova' are visually nice I
would like to keep more navigation possibilities at the start page like
in 'cloudstack'.
Best regards,
Timo
Am 26.03.2013 14:03, schrieb Maruan Sahyoun:
> Hi there,
>
> what do you think about giving the PDFBox website an overhaul similar to
>
> http://cloudstack.apache.org/
> http://ode.apache.org/index.html
> http://cordova.apache.org
>
> with a more prominent user guide such as http://ode.apache.org/userguide/
> and a cleaner architecture description (together with main classes) for developers
>
> to support a faster intro into pdfbox
>
> Kind regards
>
> Maruan Sahyoun
>
--
Timo Boehme
OntoChem GmbH
H.-Damerow-Str. 4
06120 Halle/Saale
T: +49 345 4780474
F: +49 345 4780471
timo.boehme@ontochem.com
_____________________________________________________________________
OntoChem GmbH
Geschäftsführer: Dr. Lutz Weber
Sitz: Halle / Saale
Registergericht: Stendal
Registernummer: HRB 215461
_____________________________________________________________________