ERDWIssues

ERG Reference Documentation Working Group Open Issues

• What "documentation" work has already been done. Need to do a survey
  • Francis work with web interface to browse grammar
  • Annotations in the source
  • The Wiki
  • Existing papers
  • etc.
• Where does the documentation live?
• What form are the docs written in?
• How do you search?
• Who can help write content?
• Are there two sets of some docs?
  • One set for folks who just need practical how to stuff (including Grad Students)?
  • One set for grammarians, Grad Students?
  • We will see how far we can get unifying these in our prototyping
• How does the community feel about erase existing wiki content? Feels destructive. Do we have a history that we can revert to? Or are we always writing new docs?
• Understand how to exploit the mechanism that francis and colleges have built to to tie examples with example sentences better for grammarians
• Figure out how to do release notes with the grammar
  • Changes to grammar rule names: irritating but inevitable. Give some thought to the fact that underlying things will change. Find a way to alert people that changes have happened.