Coder Social home page Coder Social logo

nextcloudpi-readthedocs's People

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

nextcloudpi-readthedocs's Issues

Finding better ways to write and maintain documentation

Hi Guys,

Quit a bit work has gone into moving from github wiki to readthedocs. But sorry to say, I am not happy at all with it.
I find editing very frustrating, and especially making changes to structure, which happens regularly, as we expand in functionality.

Creating and editing pages has become even more 'noob' unfriendly, as there is no visual editor any more. It's okay for me, I have learned markdown, but it will not make it easier for others to contribute.

Even a Wordpress Documentation Plugin would be better then this imho.

I created a devel branch here to see if I could edit and add a Upgrades menu item and move relevant pages, but afaik there is no way to move pages, and it would break all the links, which I can not test, as they will and need be pointing to master branch.

I really don't want to spend that much time editing and reorganizing pages on a regular base.

So I vote to: look for and move to a more suitable platform, or just return to the github wiki.

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.