-
Notifications
You must be signed in to change notification settings - Fork 506
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Regressive Web Documentation #1374
Comments
(sorry went a bit fast in transfering it, my bad) But the fact that the doc was lost looks like a kivy issue first. |
Thanks, I'd suspect a Kivy issue too. Strangely the Kivy install instruction are for 2.0.0 (uses [base] etc), even if if says 1.11.1 in the top left. I posted here because Buildozer install instruction are old ones. Not clear to me I know how to check the extent of the issue. |
This KivyMD script also implements the old install instructions https://github.com/HeaTTheatR/KivyMD-data/blob/master/install-kivy-buildozer-dependencies.sh |
Actually, i understood the other day, though its' really not obvious, but Now the issue is that the instructions for buildozer are obsolete in this version, so a fix to these in the |
It looks like that is not exactly the issue because: Buildozer has no branch or tag labeled 'stable' on github. Buildozer does have a 'master' branch github, but for Buildozer install docs the 'master' on 'kivy.org' does not match the 'master' on github. My original comment was too general, but the issue in publishing the documentation is real. Where is the documentation on publishing the documentation? |
Hm, so maybe kivy docs shouldn't try to tell how to install buildozer, but instead point to the buildozer docs, to avoid falling out of sync? Documentation is published automatically, for kivy through our own system, that is partially documented here https://github.com/kivy/kivy-website-docs. For buildozer and others simply using readthedocs, but it seems not to be automatic, would be nice to configure web hooks, i just pushed the button for buildozer, but it failed, apparently trying to build with python2.7x
|
I'd say do whatever is easiest. Interesting to note that the Readthedocs entry is correct for install Buildozer 1.2 (the current). And their build history is informative https://readthedocs.org/projects/buildozer/builds/
I laughed out loud. |
Description
The Kivy documentation on the web https://kivy.org/doc/stable/ has lost the documentation for Kivy 2.0.0 . It is only up to Kivy 1.11.1
This is a particular problem for Buildozer as the install documentation on the Web is incorrect. https://kivy.org/doc/stable/guide/packaging-android.html#packaging-android
For potential user reading this, the correct install documentation is https://github.com/kivy/buildozer/blob/master/docs/source/installation.rst
This regressive behavior gives rise to a truly terrible new user experience. Documentation with an implicit "ignore the parts that are wrong" is unsupportable.
The text was updated successfully, but these errors were encountered: