id,summary,reporter,owner,description,type,status,priority,milestone,component,resolution,keywords,cc,branch,branch_author,launchpad_bug
1617,Move 'notes to self' documentation aimed at developers *only* into a separate workspace.,hypatia,,"Documents such as doc/pb/specifications/schema.xhtml, which is marked as ""all preliminary and is more an exercise in semiconscious protocol design"" are mixed in amongst documents designed for use by end users rather than purely by the Twisted developers themselves. It's confusing (to me) to have them there, therefore they should be moved.

Files:
doc/pb/specifications/schema.xhtml
doc/pb/newpb-jobs.txt
doc/pb/use-cases.txt
./doc/core/vision/philosophy.xhtml
./doc/core/vision/naming.xhtml
./doc/core/vision/security.xhtml

To be consistent ./doc/core/howto/policy/ should probably move likewise.

Unless advised otherwise, I will make doc/development and, say, doc/development/plans, doc/development/plans/pb and doc/development/policy",enhancement,closed,highest,,core,fixed,documentation,hypatia jml,,,