[website] Move guidelines and developer documentation to Trac?
Hello all, The guidelines and developer documentation on the boost site are getting a bit old, and no one's really updating them. Meanwhile new developer documentation is being written on the Trac wiki. It seems confusing to split the documentation over two sites, and most developers find it easier to update the wiki so it might be a good idea to move all the developer documentation over to the wiki and the Trac would become the 'developer's site'. This could also help improve the main boost site. It could be simpler and more focussed towards users. Some developer pages would probably have to remain on the site for technical reasons (such as test results) and some articles might not be appropriate, or we might not have the author's permission to put them on a wiki. The developer section would be replaced by a page suggesting how to contribute to boost (along the lines of http://lists.boost.org/MailArchives/boost-docs/2010/01/3960.php). We'd also keep the calendar on the main site in some form, as it can be useful for users. Any thoughts? Daniel
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Daniel James Sent: Sunday, February 07, 2010 4:14 PM To: boost@lists.boost.org Subject: [boost] [website] Move guidelines and developer documentation to Trac?
The guidelines and developer documentation on the boost site are getting a bit old, and no one's really updating them. Meanwhile new developer documentation is being written on the Trac wiki. It seems confusing to split the documentation over two sites, and most developers find it easier to update the wiki so it might be a good idea to move all the developer documentation over to the wiki and the Trac would become the 'developer's site'.
This could also help improve the main boost site. It could be simpler and more focussed towards users. Some developer pages would probably have to remain on the site for technical reasons (such as test results) and some articles might not be appropriate, or we might not have the author's permission to put them on a wiki.
The developer section would be replaced by a page suggesting how to contribute to boost (along the lines of http://lists.boost.org/MailArchives/boost-docs/2010/01/3960.php). We'd also keep the calendar on the main site in some form, as it can be useful for users.
Any thoughts?
Agree 100%. Paul --- Paul A. Bristow Prizet Farmhouse Kendal, UK LA8 8AB +44 1539 561830, mobile +44 7714330204 pbristow@hetp.u-net.com
Paul A. Bristow wrote:
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Daniel James Sent: Sunday, February 07, 2010 4:14 PM To: boost@lists.boost.org Subject: [boost] [website] Move guidelines and developer documentation to Trac?
The guidelines and developer documentation on the boost site are getting a bit old, and no one's really updating them. Meanwhile new developer documentation is being written on the Trac wiki. It seems confusing to split the documentation over two sites, and most developers find it easier to update the wiki so it might be a good idea to move all the developer documentation over to the wiki and the Trac would become the 'developer's site'.
This could also help improve the main boost site. It could be simpler and more focussed towards users. Some developer pages would probably have to remain on the site for technical reasons (such as test results) and some articles might not be appropriate, or we might not have the author's permission to put them on a wiki.
The developer section would be replaced by a page suggesting how to contribute to boost (along the lines of http://lists.boost.org/MailArchives/boost-docs/2010/01/3960.php). We'd also keep the calendar on the main site in some form, as it can be useful for users.
Any thoughts?
Agree 100%.
I recall some mention about migrating away from Trac to something with better performance. If that would occur, then migration of tons of Wiki with control of proper structure may be a problem Perhaps it's worth to consider. Best regards, -- Mateusz Loskot, http://mateusz.loskot.net Charter Member of OSGeo, http://osgeo.org
On 7 February 2010 17:10, Mateusz Loskot <mateusz@loskot.net> wrote:
I recall some mention about migrating away from Trac to something with better performance. If that would occur, then migration of tons of Wiki with control of proper structure may be a problem Perhaps it's worth to consider.
I missed this, is this likely? But it's only going to be about 10-20 pages, small enough for manual transfer. Daniel
Daniel James wrote:
On 7 February 2010 17:10, Mateusz Loskot <mateusz@loskot.net> wrote:
I recall some mention about migrating away from Trac to something with better performance. If that would occur, then migration of tons of Wiki with control of proper structure may be a problem Perhaps it's worth to consider.
I missed this, is this likely?
I don't know it.
But it's only going to be about 10-20 pages, small enough for manual transfer.
Right, not many. Best regards, -- Mateusz Loskot, http://mateusz.loskot.net
participants (3)
-
Daniel James -
Mateusz Loskot -
Paul A. Bristow