SUMMARY The Kate Handbook [1] is supposed to be in the Development version --- but it reports version 21.04, which is behind the released version 21.08. STEPS TO REPRODUCE 1. Read the Kate Handbook [1]! OBSERVED RESULT Revision Applications 21.04 (2021-03-06) EXPECTED RESULT Revision Applications 21.12 (TBD) SOFTWARE/OS VERSIONS Windows: macOS: Linux/KDE Plasma: openSUSE Tumbleweed 20210829 (available in About System) KDE Plasma Version: 5.22.4 KDE Frameworks Version: 5.85.0 Qt Version: 5.15.2 ADDITIONAL INFORMATION [1] <URL: https://docs.kde.org/trunk5/en/kate/kate/index.html >
The document was revised in the timeframe of 21.04; the document itself says that it documents Kate version 18.12, which -- judging from some of the test -- is the time when most of that handbook was written. That's not really surprising, since the documentation is a story about the software, and even if it is generated from the development branch of the repository, the story about the software remains whatever was most recently written.
The date is by policy the last revision of the documentation, to ensure the document is checked. It is not the last version of the application.
(In reply to Luigi Toscano from comment #2) > The date is by policy the last revision of the documentation, to ensure the > document is checked. It is not the last version of the application. How often is documentation revised?
(In reply to Christopher Yeleighton from comment #3) > (In reply to Luigi Toscano from comment #2) > > The date is by policy the last revision of the documentation, to ensure the > > document is checked. It is not the last version of the application. > > How often is documentation revised? When somebody spots interface changes, when there is a typo found somewhere, when developers want to add something, when it is needed for some other reason.
(In reply to Yuri Chornoivan from comment #4) > (In reply to Christopher Yeleighton from comment #3) > > (In reply to Luigi Toscano from comment #2) > > > The date is by policy the last revision of the documentation, to ensure the > > > document is checked. It is not the last version of the application. > > > > How often is documentation revised? > > When somebody spots interface changes, when there is a typo found somewhere, > when developers want to add something, when it is needed for some other > reason. That looks like yesterday. I am confused.
(In reply to Christopher Yeleighton from comment #5) > (In reply to Yuri Chornoivan from comment #4) > > (In reply to Christopher Yeleighton from comment #3) > > > (In reply to Luigi Toscano from comment #2) > > > > The date is by policy the last revision of the documentation, to ensure the > > > > document is checked. It is not the last version of the application. > > > > > > How often is documentation revised? > > > > When somebody spots interface changes, when there is a typo found somewhere, > > when developers want to add something, when it is needed for some other > > reason. > > That looks like yesterday. I am confused. This is not a question, it is a statement.
(In reply to Yuri Chornoivan from comment #6) > This is not a question, it is a statement. Under the assumption that the trunk documentation gets revised when updated, and given that it has recently been updated, why hasn’t it been revised?
(In reply to Christopher Yeleighton from comment #7) > (In reply to Yuri Chornoivan from comment #6) > > This is not a question, it is a statement. > > Under the assumption that the trunk documentation gets revised when updated, > and given that it has recently been updated, why hasn’t it been revised? Because authors do not want to do so.
(In reply to Yuri Chornoivan from comment #8) > Because authors do not want to do so. I am an author now and I certainly want it to be revised.
(In reply to Christopher Yeleighton from comment #9) > (In reply to Yuri Chornoivan from comment #8) > > Because authors do not want to do so. > > I am an author now and I certainly want it to be revised. Ok. Do it.
(In reply to Yuri Chornoivan from comment #10) > Ok. Do it. If that is the case, may I reopen?
(In reply to Christopher Yeleighton from comment #11) > (In reply to Yuri Chornoivan from comment #10) > > Ok. Do it. > > If that is the case, may I reopen? How can I prohibit this? You have been said that nobody will implement this bikeshedding bug report now but you are free to reopen it.
(In reply to Yuri Chornoivan from comment #12) > (In reply to Christopher Yeleighton from comment #11) > > (In reply to Yuri Chornoivan from comment #10) > > > Ok. Do it. > > > > If that is the case, may I reopen? > > How can I prohibit this? You have been said that nobody will implement this > bikeshedding bug report now but you are free to reopen it. What do you mean by nobody? I am somebody for sure.
This bug is not a bug and shall stay closed.
(In reply to Luigi Toscano from comment #14) > This bug is not a bug and shall stay closed. Which part of the information provided by Yuri is incorrect?
(In reply to Christopher Yeleighton from comment #15) > (In reply to Luigi Toscano from comment #14) > > This bug is not a bug and shall stay closed. > > Which part of the information provided by Yuri is incorrect? Please see my initial answer. Don't report further "the documentation is outdated" bugs.
(In reply to Luigi Toscano from comment #16) > Please see my initial answer. Don't report further "the documentation is > outdated" bugs. How often is documentation revised?
Documentation is updated when someone updates it. There is no automatic updating just because the program it documents gets updated. There is no regular schedule for updating documentation. The issue is that the developers who updated the code do not usually update the documentation, so that task simply waits until someone willing to update the documentation does so. A very few application have dedicated folks who maintain their docs, but most depend on a core crew of doc writers. A bug is not necessary to update documentation - an email to the doc team's mailing list is likely to work as well. The documentation files include the version of the program for which the docs were last updated, and the date those updates were done. For the reasons above, these often do lag behind the current version of the program. That is not a bug, but an unfortunate reality.