Giter VIP home page Giter VIP logo

Comments (8)

dakrauth avatar dakrauth commented on August 23, 2024

That is a build from someone else's fork. I've been trying to get the latest docs built on RTD, but for some reason they keep failing. Everything builds fine locally and there really isn't anything in the build log on the site to indicate the issue.

from django-swingtime.

rcooke avatar rcooke commented on August 23, 2024

I'll help if I can. What is the RTFD url to your docs?

from django-swingtime.

dakrauth avatar dakrauth commented on August 23, 2024

https://readthedocs.org/projects/swingtime/

I've published the docs on my own site as well: http://swingtime.nerdfog.com/ (and click the documentation button).

from django-swingtime.

rcooke avatar rcooke commented on August 23, 2024

Dude, these links should really be in your readme - it would have saved me a few grey hairs!

Is the nerdfog domain stable? If it is, I will start by changing the Django Project entry for Swingtime to point to that instead of the Fiee outdated docs.

from django-swingtime.

dakrauth avatar dakrauth commented on August 23, 2024

I never added the RTD links in the README doc for 2 reasons: swingtime pre-dated RTD, and I have no control over that domain or, apparently, how the docs are built (or not!). The nerdfog domain is just a stop gap while I investigate getting the current release and latest commits to build on RTD.

The docs and instructions for building them are included in this github repo, so you can always clone it and build locally, as well as run the demo project.

from django-swingtime.

rcooke avatar rcooke commented on August 23, 2024

True. I see your points. I would still advocate a paragraph about this in the readme, so people trying to evaluate your project for integration into other things don't wind up reading those outdated docs.

If/when you move to a new domain, the Django Projects links can be revised.

Thanks for the info! I was "voluntold" to make an event calendar for a local Church. I figure if I have to do this once, I'm gonna make sure its available for others. Your library is missing a couple of their requirements, so I'm trying to base on django-scheduler (not schedule), but I want to use your fantastic rule generator form.

from django-swingtime.

rcooke avatar rcooke commented on August 23, 2024

I'm going to assume that when you first created the RTFD project you choose "Sphinx" and not "MkDocs". Please correct me if needed.

Can you push tags for all your releases? It would be handy to try a build on older versions to see when/where it broke. As per:

http://read-the-docs.readthedocs.org/en/latest/versions.html#how-we-envision-versions-working

from django-swingtime.

rcooke avatar rcooke commented on August 23, 2024

Have you tried erasing the build folder?

http://read-the-docs.readthedocs.org/en/latest/builds.html#deleting-a-stale-or-broken-build-environment

from django-swingtime.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.