Re: [Firebird-docs] Firebird File and Metadata Security migrated
On 01-07-2020 18:59, Mark Rotteveel wrote: > > A large table of contents that covers everything will only overwhelm. I think > a short list of the documentation with a short > summary of the subjects covered would be better than a cross-document > table-of-contents. > > But I also think that some of the existing documentation should maybe be > moved to an 'attic' (as in: move it out of the way, but keep it accessible as > it might be interesting for some, but generally not > very useful due to age > or incompleteness). > > Mark > -- > Mark Rotteveel Well, I don't want a TOC for everything. But everything that covers our product "Firebird" should be accessible in one place. So an outstanding guy will find useful information in one place. Of course this can be a single page or something else. Regards Martin ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Firebird File and Metadata Security migrated
On 01-07-2020 18:43, Köditz, Martin wrote: I think a large table of contents makes sense. Even I find it difficult to find documents sometimes. How should a newcomer know in which area a document is or that it exists at all. That's why I prefer a single large table of contents. A large table of contents that covers everything will only overwhelm. I think a short list of the documentation with a short summary of the subjects covered would be better than a cross-document table-of-contents. But I also think that some of the existing documentation should maybe be moved to an 'attic' (as in: move it out of the way, but keep it accessible as it might be interesting for some, but generally not very useful due to age or incompleteness). Mark -- Mark Rotteveel ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Firebird File and Metadata Security migrated
Hello, I think a large table of contents makes sense. Even I find it difficult to find documents sometimes. How should a newcomer know in which area a document is or that it exists at all. That's why I prefer a single large table of contents. Regards Martin ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Firebird File and Metadata Security migrated
Hello, I support the idea of the single Page list/index for all docs. I suggest that we should create such page, and then ask people about their opinion (it will also increase awareness of documentation). Regards, Alexey Kovyazin ср, 1 июл. 2020 г., 16:31 Paul Vinkenoog : > Mark Rotteveel wrote: > > > I migrated the Firebird File and Metadata Security document. > (...) > > I do wonder if this document really belongs under 'Reference Manuals', I > > think it would be more suitable under White Papers & Presentations.. > > I think the whole categorization is seriously flawed. > > First we have the top-level categories: > > - Release Notes > - Reference Manuals > - White Papers & Presentations > - FAQ > - Firebird Books > - Drivers Documentation > - Third-Party Docs and Articles > > each corresponding to a separate webpage. > > Then within those categories (i.e. on most of those webpages) we have > further subdivisions. For the page "Reference Manuals", they are: > > - Current Versions > - Firebird Command Line Tools > - Various User Manuals > - Reference Material (h? I thought the whole page was Reference > Manuals) > - Firebird Licenses > > and a couple more. > > Given the fact that the bulk of our docs is on the "Reference Manuals" > page, even if they aren't reference manuals, I think that the Firebird > File and Metadata Security document is reasonably well placed under > "Various User Manuals". > > Now, this isn't a pressing matter, but I do think that we should have > the Doc index back on a single page again (except maybe for a few docs/ > categories that are heavily "niche" and/or outdated and/or third-party), > with categories that make sense, and without separate lines for each > language version, because that's eating up huge amounts of vertical > space. > > Paul Vinkenoog > > > ___ > Firebird-docs mailing list > Firebird-docs@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/firebird-docs > ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
Re: [Firebird-docs] Firebird File and Metadata Security migrated
Mark Rotteveel wrote: > I migrated the Firebird File and Metadata Security document. (...) > I do wonder if this document really belongs under 'Reference Manuals', I > think it would be more suitable under White Papers & Presentations.. I think the whole categorization is seriously flawed. First we have the top-level categories: - Release Notes - Reference Manuals - White Papers & Presentations - FAQ - Firebird Books - Drivers Documentation - Third-Party Docs and Articles each corresponding to a separate webpage. Then within those categories (i.e. on most of those webpages) we have further subdivisions. For the page "Reference Manuals", they are: - Current Versions - Firebird Command Line Tools - Various User Manuals - Reference Material (h? I thought the whole page was Reference Manuals) - Firebird Licenses and a couple more. Given the fact that the bulk of our docs is on the "Reference Manuals" page, even if they aren't reference manuals, I think that the Firebird File and Metadata Security document is reasonably well placed under "Various User Manuals". Now, this isn't a pressing matter, but I do think that we should have the Doc index back on a single page again (except maybe for a few docs/ categories that are heavily "niche" and/or outdated and/or third-party), with categories that make sense, and without separate lines for each language version, because that's eating up huge amounts of vertical space. Paul Vinkenoog ___ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs