From david.nind at gmail.com Mon Dec 2 16:23:19 2019 From: david.nind at gmail.com (David Nind) Date: Tue, 3 Dec 2019 04:23:19 +1300 Subject: [Koha-docs] Documentation update Message-ID: Just a quick update on a couple of things: - Two changes made to master over the weekend - Git settings for removing trailing spaces - Git commit messages - Team for the next release - Kohacon20 *Two changes made to master over the weekend* Over the weekend I merged two changes to master (19.11) and 19.05 (it will take me a bit longer to get these into 18.11). While mainly housekeeping, they made changes to most source files and covered: - removing spaces at the end of lines, and removing extra lines; and - fixing some of the issues that were generating warning messages when creating the HTML version of the manual. I haven't fixed all the warning messages, but the bulk of them are out of the way. This should significantly reduce broken links in the manual. If you have any work in progress, I'm happy for you to do your commits and merge requests based on whatever state your local git repository is in - I'll then try and resolve any conflicts. Otherwise, a git pull is highly recommended to get your local repository up-to-date for new work! *Git settings for removing trailing spaces* To avoid lines getting into the repository with extra spaces at the end, you can setup git so that it automatically removes these when commits are made. You can check to see what is in your git configuration file using git config --list Add these entries, if they don't exist: git config --global core.whitespace trailing-space,space-before-tab git config --global apply.whitespace fix See the wiki for the full details. Your editor may also have a setting that removes trailing spaces automatically as well., *Git commit messages* For recent commits I've been amending commit messages so they are more in line with what Koha does, and to make the history a bit more readable: 404b0ed9 Taiga 1015: Fix sphinx warning messages when HTML generated d9e70d4b Taiga 1058: Remove trailing spaces and extra blank lines in source files 664fdb99 Taiga 787 (11911): Add note about suggestions_manage permission 6ce2a4b1 Bug 24122: Fix typo .... I've added some guidelines to the wiki with some examples. *Team for the next release* Thanks to everyone who has volunteered to help with the documentation! (You can still add your name to the list, and contributions of any kind are always welcome.) *Kohacon20* I submitted a couple of proposals about documentation for Kohacon20 (in October next year, here in Wellington, New Zealand!). One was a talk about the future of documentation for Koha, and the other was to have documentation workshop. We'll see how it goes... That's all for the moment! David Nind | david.nind at gmail.com PO Box 12367, Thorndon, Wellington, New Zealand 6144 m. +64 21 0537 847 -------------- next part -------------- An HTML attachment was scrubbed... URL: