Re: Version documentation... Re: Is your package really documented? The truth

On 30 Apr 2004 at 0:26, Klaus Guenther wrote: > I'm about to release HTML_Page2. HTML_Page is not documented. Should the > documentation be classified under HTML_Page or HTML_Page2? It is possible > that people will stick to individual versions (e.g., if MDB2 == DB_v2, then > replacing the DB docs would be foolish). However, I'm not going to release > docs for HTML_Page. That will remain as-is. And I'll only document my 2.x > series. Still I'd favor having documentation for HTML_Page2, not generally HTML_Page. There are some packages which still actively support there 1.x-versions, maybe because 2.x is php5-only or similar. And since a new major most times also means a drastically changed API, I'd prefer to have api-docs for both major version. If you're not going to document HTML_Page that's fine with me - but naming should be consistent in my eyes, so adding the "2" to the name is imho needed. Stefan