Thanks Tibor I've been seeing lots of cool changes come through on Trac.

I applaud the move of the hacking guides to wither the Trac wiki or the epydoc. 
  I think it might make sense to have them in the wiki actually, with links 
into epydoc for the actual API docs.

Something like:

http://invenio-demo.cern.ch/help/hacking/miscutil-errorlib

or

http://invenio-demo.cern.ch/help/hacking/test-suite

Belong in the wiki, I think, while

http://invenio-demo.cern.ch/help/hacking/bibconvert-api

belongs in the epydoc...

As to the rest of the organization I think it makes as much sense as any.   Of 
course these things always grow and change.

What are you thinking here wrt:

1) INSPIRE, ADS, other partner instance development pages (here these, I think 
remain separate for now, but I could see a future where they come in)  I 
wondered a bit about what you see on the Community/xxyx pages.
2) Specific admin information for CDS, INSPIRE, etc.   (I think it is clear 
that these stay in twiki/some other system)

Best
Travis



On Jun 16, 2010, at 11:54 PM, Tibor Simko wrote:

> Hi gang:
> 
> Before starting massive move of our existing (i) software distribution
> pages and (ii) twiki pages to invenio-software.org, I've been thinking
> roughly about the following site structure and wiki page categories.
> (See an illustrative example below.)  Please let me know any suggestions
> you may have.
> 
> Coding/API
> Coding/Standards
> Coding/Debugging
> Coding/GettingStarted
> Coding/Practices
> Coding/Workflow
> Coding/Kwalitee
> Coding/Layers
> Coding/TestSuite
> Coding/UsefulScripts
> Coding/Modules/BibEdit
> Coding/Modules/BibCheck
> Coding/Modules/BibMerge
> Coding/Modules/WebTag
> Coding/Projects/ImageSimilarity
> Coding/Projects/SWORD/Server
> Coding/Projects/SWORD/Client
> Community/Sites
> Community/MailingLists
> Community/ChatRooms
> Community/Blogs
> Community/Support
> Community/Translations
> Community/SubmittingPatches
> Community/UniversityFoo
> Community/UniversityBar
> Community/ProjectXyzzy/Fuux
> Community/ProjectXyzzy/Buux
> Community/ProjectZyxxy
> General/Articles
> General/Demo
> General/Features
> General/Roadmap
> General/Talks
> Installation/Download
> Installation/InvenioOnDebian
> Installation/InvenioOnGentoo
> Installation/Upgrading
> Installation/ReleaseNumbering
> Installation/Tuning
> Installation/Profiling
> Howtos/HowtoRestrictCollections
> Howtos/HowtoConfigureSubmissionFields
> Howtos/HowtoUploadBacklogFiles
> Howtos/HowtoIncreasePerformance
> Releases/0.99.1
> Releases/0.99.2
> Musings/Usability/Homepage
> Musings/Usability/SearchClustering
> Tools/EmacsAdvocacy
> Tools/EmacsGettingStarted
> Tools/EmacsTips
> Tools/GitAdvocacy
> Tools/GitGettingStarted
> Tools/GitTips
> Tools/PythonGettingStarted
> Tools/PythonGotchas
> Tools/PythonPerformance
> Users/ErikaMustermann
> Users/JohnDoe
> 
> Best regards
> -- 
> Tibor Simko

Travis C. Brooks
Manager of Information Systems & SPIRES/INSPIRE
SLAC National Accelerator Laboratory Library
http://www.slac.stanford.edu/spires/




Reply via email to