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?

• I'm unclear about our comfort level with linking and citations from"the literature" and what is considered definitive, etc. Be good to establish this (for ericz at least).

• Understand how to exploit the mechanism that francis and colleges have built to to tie examples with example sentences better for grammarians

  • Having the doc strings in the grammar has worked well in principle but in practice we can't share the burden beyond Dan. Is there a branch of the ERG where people can put in docs and it gets reviewed?
  • How large is the pool of people that can document the semantics of the ERG?

• 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.

• How to getting visibility into the current plan for the ERG?