On Wed, 2012-06-20 at 11:13 +0200, [email protected] wrote:
> Hi!
> > > The Linux Test Project test suite has been released for the month of
> > > JUNE 2012.
> > > 
> > > The latest version of the test-suite contains 3000+ tests for the Linux
> > > OS and can be found at:
> > > http://ltp.sourceforge.net/,
> > > Latest happenings in LTP can also be found at:
> > > http://ltp.sourceforge.net/wiki/,
> > > http://ltp.sourceforge.net/wikiArchives.php, and,
> > > IRC: irc.freenode.org #ltp.
> > > 
> > > Our web site also contains other information such as:
> > > - A Linux test tools matrix
> > > - Technical papers
> > > - How To's on Linux testing
> > > - Code coverage analysis tool.
> > 
> > The wiki front page references some pretty old events. Some options that
> > comes into my mind:
>  
> Yes, I know that, and this is something that's on my long TODO. The
> priority is quite low though.
> 
> > 1) Remove the sourceforge site, port the relevant documentation to a
> > github wiki [1], and move the site to be hosted under the github
> > infrastructure, ltp.github.com
> > 2) Just heavily clean up and organize the existing sourceforge wiki.
> 
> Well I think that github wiki is improvement so I would personaly would
> vote for number 1.
> 
> Also note that we do have some relevant docs under doc/ directory in our
> git tree currently in asciidoc format. So maybe having sf.net pages with
> content generated form asciidoc by typing make in doc directory would be
> sufficient. That way we would have git backend wiki, the only
> unconvinient part is that somebody needs to upload the pages (but that
> could be backed up by the git syncing script that's allready runing as
> well).

I have quite some experience of migrating/cleaning project documentation
to github, so yeah, I believe I can help with it. A good thing about
github wikis is that they are git repos, and the wiki engine is open
source, you can run it on your own machine.

> > Obviously this is just a suggestion, please don't be mad at me :) I find
> > useful to keep disciplined and try to keep the online documentation tidy
> > and up to date (although this is a difficult goal indeed).
> 
> I'm not mad at all, quite contrary. I know that having good
> documentation is important, unfortunately it looks like nobody has time
> to write it. Are you volunteering? I would be happy to give you commit
> access ;).

I will help with it. I'll start to sketch a new LTP page using twitter
bootstrap and will look at the process that could be used to do semi
automated translation of the current documentation to restructured text.

Cheers,

Lucas


------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________
Ltp-list mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/ltp-list

Reply via email to