Warning, /office/calligra/doc/status.txt is written in an unsupported language. File is not indexed.
0001 Status overview of the Calligra manuals 0002 -------------------------------------- 0003 0004 General goal for Calligra 2.0: all applications should have up-to-date and 0005 feature-complete manuals. 0006 0007 - The user interfaces should be fully described (toolbars, menus, etc.) and 0008 the screenshots should match the actual looks and be consistent in style and 0009 presentation. A consistent way of describing the menu entries would be very 0010 nice as well. 0011 0012 - Common tasks should be described in a clear way, where needed using a how-to 0013 or tutorial like approach. 0014 0015 - Technical information should be separated from actual user information. 0016 Whether we should put developer stuff in a separate handbook or just remove 0017 it from the manuals completely is an open question for me at this point. 0018 0019 - Especially for the larger applications: we should take a look at other 0020 manuals and their tables of contents to see what information is included and 0021 how they present it. A good theft is better than a bad idea, after all... 0022 0023 The list of maintainers should be kept up-to-date at the Calligra "get 0024 involved" documentation page: http://calligra.org/getinvolved/doc-writers.php 0025 0026 -------------------------------------------------------------------------------- 0027 0028 Calligra - general 0029 0030 Too technical - basically a complete rewrite is needed. More focus on the 0031 common interface and on the component system, less on the technicalities 0032 (don't mention KPart!). General configuration options may be included, but on 0033 the UI level only. This depends on the 2.0 user interface though. Perhaps even 0034 remove this part and combine the useful information with KOShell? 0035 0036 KOShell (Calligra workspace) 0037 0038 Update for 2.0 interface - this goes for all parts, let's just mention it 0039 here. The "Under the hood" section should be moved to developer documentation, 0040 the rest seems to be fine. 0041 0042 Words 0043 0044 The introduction and the Fundamentals should be restyled. 0045 Most of the appendices, but also some other sections, are pretty much 0046 outdated. (1.3!) 0047 0048 Tables 0049 0050 Not much additional remarks. 0051 0052 Stage 0053 0054 Some stuff is outdated (1.3!). Apart from the Menu/Toolbar items chapter, 0055 there are almost no screenshots and only very little actual text. 0056 It's also questionable if we should include tips on how you should do 0057 presentations. If so, it ought to be an appendix, not a running chapter. 0058 0059 Karbon 0060 0061 Easy: no documentation at all. 0062 0063 KChart 0064 0065 Fairly complete. 0066 0067 KFormula 0068 0069 Fairly complete.