From 02af709cf49e0242de8bd27db93201b1efc1fca1 Mon Sep 17 00:00:00 2001 From: Bernhard Posselt Date: Tue, 12 Mar 2013 17:42:35 +0100 Subject: [PATCH] finished structuring --- .../app/{ => app}/classloader.rst | 0 developer_manual/app/{ => app}/css.rst | 0 .../app/{ => app}/data-migration.rst | 0 developer_manual/app/{ => app}/database.rst | 0 .../app/{ => app}/externalapi.rst | 0 developer_manual/app/{ => app}/filesystem.rst | 0 developer_manual/app/{ => app}/hooks.rst | 0 developer_manual/app/app/index.rst | 18 ++ developer_manual/app/{ => app}/info.rst | 0 developer_manual/app/{ => app}/javascript.rst | 0 developer_manual/app/{ => app}/schema.rst | 0 developer_manual/app/{ => app}/static.rst | 0 developer_manual/app/{ => app}/tutorial.rst | 0 developer_manual/app/contents.rst | 21 --- developer_manual/app/general/kanban.rst | 2 +- developer_manual/app/index.rst | 16 +- .../app/{appintro => intro}/createapp.rst | 0 .../{appintro => intro}/gettingstarted.rst | 0 .../app/{appintro => intro}/index.rst | 0 developer_manual/commun/index.rst | 17 ++ developer_manual/contents.rst | 6 +- developer_manual/core/index.rst | 13 +- developer_manual/documentation/index.rst | 7 + developer_manual/index.rst | 157 +++--------------- developer_manual/testing/index.rst | 7 + developer_manual/translation/index.rst | 8 + 26 files changed, 106 insertions(+), 166 deletions(-) rename developer_manual/app/{ => app}/classloader.rst (100%) rename developer_manual/app/{ => app}/css.rst (100%) rename developer_manual/app/{ => app}/data-migration.rst (100%) rename developer_manual/app/{ => app}/database.rst (100%) rename developer_manual/app/{ => app}/externalapi.rst (100%) rename developer_manual/app/{ => app}/filesystem.rst (100%) rename developer_manual/app/{ => app}/hooks.rst (100%) create mode 100644 developer_manual/app/app/index.rst rename developer_manual/app/{ => app}/info.rst (100%) rename developer_manual/app/{ => app}/javascript.rst (100%) rename developer_manual/app/{ => app}/schema.rst (100%) rename developer_manual/app/{ => app}/static.rst (100%) rename developer_manual/app/{ => app}/tutorial.rst (100%) delete mode 100644 developer_manual/app/contents.rst rename developer_manual/app/{appintro => intro}/createapp.rst (100%) rename developer_manual/app/{appintro => intro}/gettingstarted.rst (100%) rename developer_manual/app/{appintro => intro}/index.rst (100%) create mode 100644 developer_manual/commun/index.rst create mode 100644 developer_manual/documentation/index.rst create mode 100644 developer_manual/testing/index.rst create mode 100644 developer_manual/translation/index.rst diff --git a/developer_manual/app/classloader.rst b/developer_manual/app/app/classloader.rst similarity index 100% rename from developer_manual/app/classloader.rst rename to developer_manual/app/app/classloader.rst diff --git a/developer_manual/app/css.rst b/developer_manual/app/app/css.rst similarity index 100% rename from developer_manual/app/css.rst rename to developer_manual/app/app/css.rst diff --git a/developer_manual/app/data-migration.rst b/developer_manual/app/app/data-migration.rst similarity index 100% rename from developer_manual/app/data-migration.rst rename to developer_manual/app/app/data-migration.rst diff --git a/developer_manual/app/database.rst b/developer_manual/app/app/database.rst similarity index 100% rename from developer_manual/app/database.rst rename to developer_manual/app/app/database.rst diff --git a/developer_manual/app/externalapi.rst b/developer_manual/app/app/externalapi.rst similarity index 100% rename from developer_manual/app/externalapi.rst rename to developer_manual/app/app/externalapi.rst diff --git a/developer_manual/app/filesystem.rst b/developer_manual/app/app/filesystem.rst similarity index 100% rename from developer_manual/app/filesystem.rst rename to developer_manual/app/app/filesystem.rst diff --git a/developer_manual/app/hooks.rst b/developer_manual/app/app/hooks.rst similarity index 100% rename from developer_manual/app/hooks.rst rename to developer_manual/app/app/hooks.rst diff --git a/developer_manual/app/app/index.rst b/developer_manual/app/app/index.rst new file mode 100644 index 000000000..b93ab31f4 --- /dev/null +++ b/developer_manual/app/app/index.rst @@ -0,0 +1,18 @@ +=========================================== +App Developement Using the ownCloud App API +=========================================== + +.. toctree:: + :maxdepth: 1 + + tutorial + info + schema + database + static + css + javascript + externalapi + filesystem + hooks + data-migration diff --git a/developer_manual/app/info.rst b/developer_manual/app/app/info.rst similarity index 100% rename from developer_manual/app/info.rst rename to developer_manual/app/app/info.rst diff --git a/developer_manual/app/javascript.rst b/developer_manual/app/app/javascript.rst similarity index 100% rename from developer_manual/app/javascript.rst rename to developer_manual/app/app/javascript.rst diff --git a/developer_manual/app/schema.rst b/developer_manual/app/app/schema.rst similarity index 100% rename from developer_manual/app/schema.rst rename to developer_manual/app/app/schema.rst diff --git a/developer_manual/app/static.rst b/developer_manual/app/app/static.rst similarity index 100% rename from developer_manual/app/static.rst rename to developer_manual/app/app/static.rst diff --git a/developer_manual/app/tutorial.rst b/developer_manual/app/app/tutorial.rst similarity index 100% rename from developer_manual/app/tutorial.rst rename to developer_manual/app/app/tutorial.rst diff --git a/developer_manual/app/contents.rst b/developer_manual/app/contents.rst deleted file mode 100644 index b4b81a4b4..000000000 --- a/developer_manual/app/contents.rst +++ /dev/null @@ -1,21 +0,0 @@ -.. _contents: - -================ -App Developement -================ - -.. toctree:: - :maxdepth: 1 - - tutorial - info - classloader - schema - database - static - css - javascript - externalapi - filesystem - hooks - data-migration \ No newline at end of file diff --git a/developer_manual/app/general/kanban.rst b/developer_manual/app/general/kanban.rst index 893298988..aa7ace67f 100644 --- a/developer_manual/app/general/kanban.rst +++ b/developer_manual/app/general/kanban.rst @@ -13,7 +13,7 @@ Kanban Board = github issues + huboard We are using http://huboard.com to visualize ownCloud github issues as a `kanban board`_ (see: `core`_, `apps`_, `mirall`_): -.. figure:: ../images/kanbanexample.png +.. figure:: ../../images/kanbanexample.png :scale: 70 As you may have noticed, the columns of the kanban board represent the diff --git a/developer_manual/app/index.rst b/developer_manual/app/index.rst index fd50a9b21..845356708 100644 --- a/developer_manual/app/index.rst +++ b/developer_manual/app/index.rst @@ -1,9 +1,19 @@ -.. _index: +.. _appindex: ================ App Developement ================ +.. toctree:: + :maxdepth: 1 + :hidden: + + general/index + intro/index + app/index + appframework/index + classes/index + .. _Junior Jobs: http://owncloud.org/dev/junior-jobs/ @@ -27,8 +37,8 @@ App Developement App Developement ================ -* :doc:`appintro/gettingstarted` -* :doc:`appintro/createapp` +* :doc:`intro/gettingstarted` +* :doc:`intro/createapp` Tutorial -------- diff --git a/developer_manual/app/appintro/createapp.rst b/developer_manual/app/intro/createapp.rst similarity index 100% rename from developer_manual/app/appintro/createapp.rst rename to developer_manual/app/intro/createapp.rst diff --git a/developer_manual/app/appintro/gettingstarted.rst b/developer_manual/app/intro/gettingstarted.rst similarity index 100% rename from developer_manual/app/appintro/gettingstarted.rst rename to developer_manual/app/intro/gettingstarted.rst diff --git a/developer_manual/app/appintro/index.rst b/developer_manual/app/intro/index.rst similarity index 100% rename from developer_manual/app/appintro/index.rst rename to developer_manual/app/intro/index.rst diff --git a/developer_manual/commun/index.rst b/developer_manual/commun/index.rst new file mode 100644 index 000000000..bc4f0308c --- /dev/null +++ b/developer_manual/commun/index.rst @@ -0,0 +1,17 @@ +====================== +Help and Communication +====================== + +.. toctree:: + :maxdepth: 1 + +* Ask a question on the `mailing list`_ +* Join the `IRC channel`_ **#owncloud-dev** on **irc.freenode.net** +* `Contact`_ a maintainer of a certain app or division +* Support users on the `mailing list`_ and on the `IRC channel`_ + +* Spread the word, tell your friends about it, write a blog post! + +.. _mailing list: https://mail.kde.org/mailman/listinfo/owncloud +.. _IRC channel: irc://#owncloud-dev@irc.freenode.net +.. _Contact: http://owncloud.org/contact/ \ No newline at end of file diff --git a/developer_manual/contents.rst b/developer_manual/contents.rst index d918fc506..a0b83b1d6 100644 --- a/developer_manual/contents.rst +++ b/developer_manual/contents.rst @@ -12,10 +12,12 @@ ownCloud documentation contents .. toctree:: :maxdepth: 3 - general/index app/index core/index - classes/index + documentation/index + testing/index + translation/index + commun/index Indices and tables ================== diff --git a/developer_manual/core/index.rst b/developer_manual/core/index.rst index 97e47fca0..06187f7d5 100644 --- a/developer_manual/core/index.rst +++ b/developer_manual/core/index.rst @@ -1,11 +1,20 @@ +.. _coreindex: + ================= Core Developement ================= - .. toctree:: + :hidden: :maxdepth: 1 configfile translation theming - unit-testing \ No newline at end of file + unit-testing + +Core related docs + +* :doc:`translation` +* :doc:`unit-testing` +* :doc:`theming` +* :doc:`configfile` \ No newline at end of file diff --git a/developer_manual/documentation/index.rst b/developer_manual/documentation/index.rst new file mode 100644 index 000000000..3612a3d5e --- /dev/null +++ b/developer_manual/documentation/index.rst @@ -0,0 +1,7 @@ +============= +Documentation +============= + +.. toctree:: + :maxdepth: 1 + diff --git a/developer_manual/index.rst b/developer_manual/index.rst index 58e805ad3..1e644d45d 100644 --- a/developer_manual/index.rst +++ b/developer_manual/index.rst @@ -4,131 +4,31 @@ Developer Documentation ======================= - How to Contribute ================= -If you want to contribute please read the `Contributor agreement FAQ`_ - -* Fix and triage bugs: `Report an issue on our bug tracker`_ -* `Translate `_ ownCloud to your language -* Support users on the `mailing list`_ and on the `IRC channel`_ -* Take a job from our `Junior Jobs`_ -* Write and generate `documentation `_ -* Conduct `usability testing`_ -* Develop apps -* Spread the word, tell your friends about it, write a blog post! - -Getting Help -============ - -* Ask a question on the `mailing list`_ -* Join the `IRC channel`_ #owncloud-dev on irc.freenode.net -* `Contact`_ a maintainer of a certain app or division +If you want to contribute please read the `Contributor agreement `_ -General -======= -This chapter contains general guidelines and tutorials about ++-------------------------+-------------------------+--------------------------+ +|:doc:`app/index` |:doc:`core/index` |:doc:`documentation/index`| +| Develop apps for | Develop on the ownCloud | Create and enhance | +| ownCloud and publish on | internals | documentation | +| the `ownCloud appstore`_| | | ++-------------------------+-------------------------+--------------------------+ +|`Usability Testing`_ |:doc:`testing/index` |`Bugtracker`_ | +| Test the interface | Help to create unittests| Report, triage or fix | +| for usability | acceptance tests and | bugs to improve quality | +| | test experimental | | +| | ownCloud versions | | ++-------------------------+-------------------------+--------------------------+ +|:doc:`translation/index` |:doc:`commun/index` | | +| Translate ownCloud into | Help on IRC, the | | +| your language | mailinglist and forum | | ++-------------------------+-------------------------+--------------------------+ -* :doc:`general/security` -* :doc:`general/codingguidelines` -* :doc:`general/codereviews` -* :doc:`general/debugging` -* :doc:`general/kanban` -* :doc:`general/angular` | `AngularJS Documentation `_ -* :doc:`general/dependencyinjection` | `Pimple`_ - -App Developement -================ -General instructions how to build your apps using the AppFramework app. - -If the app is finished, it can be published in the `ownCloud app store `_ - -Tutorial --------- - -* :doc:`app/gettingstarted` - -You can choose between the traditional and MVC style (App Framework) approach. In case of the App Framework, the App Framework app has to be installed and enabled. - -* :doc:`app/apptutorial` | :doc:`app/appframeworktutorial` - -Basics ------- -* :doc:`app/settings` -* :doc:`app/classloader` -* :doc:`app/api` | :php:class:`OCA\\AppFramework\\Core\\API` - -Routing -------- -Routing connects URLs with the controller methods. - -* :doc:`app/routes` -* :php:class:`OCA\\AppFramework\\App` - -Controllers ------------ -Controllers run the database queries, pass variables to templates and return responses like JSON or templates. - -* :doc:`app/controllers` | :php:class:`OCA\\AppFramework\\Controller\\Controller` - -Database Access ---------------- -Encapsulate SQL queries into objects to be able to change them easily. - -* :doc:`app/database` | :php:class:`OCA\\AppFramework\\Db\\Mapper` - -Templates ---------- -Use templates for managing HTML code. - -* :doc:`app/templates` | :php:class:`OC_Template` -* :php:class:`OCA\\AppFramework\\Http\\TemplateResponse` - - - -JavaScript & CSS ----------------- -* :doc:`app/static` - -Testing -------- -Automatically run unittests to prevent regressions. - -* :doc:`app/unittesting` -* :php:class:`OCA\\AppFramework\\Utility\\ControllerTestUtility` - -Middleware ----------- -Execute code before or after the controller like Security checks. - -* :doc:`app/middleware` | :php:class:`OCA\\AppFramework\\Middleware\\Middleware` -* :php:class:`OCA\\AppFramework\\Middleware\\Security\\SecurityMiddleware` -* :php:class:`OCA\\AppFramework\\Middleware\\Twig\\TwigMiddleware` - -ownCloud Interfaces -------------------- -ownCloud APIs that are ready to be built into the app - -* :doc:`app/externalapi` -* :doc:`app/filesystem` -* :doc:`app/hooks` -* :doc:`app/data-migration` - - -Core Developement -================= -Core related docs - -* :doc:`core/translation` -* :doc:`core/unit-testing` -* :doc:`core/theming` -* :doc:`core/configfile` - -API Documentation -================= -* :doc:`classes/appframework/index` -* :doc:`classes/core/index` +.. _Bugtracker: https://github.com/owncloud/core/issues +.. _Usability Testing: http://jancborchardt.net/usability-in-free-software +.. _ownCloud appstore: http://apps.owncloud.com/ Index and Tables ================ @@ -136,20 +36,3 @@ Index and Tables * :ref:`modindex` -.. _Contributor agreement FAQ: http://owncloud.org/about/contributor-agreement/ - -.. _mailing list: https://mail.kde.org/mailman/listinfo/owncloud -.. _IRC channel: irc://#owncloud-dev@irc.freenode.net -.. _Contact: http://owncloud.org/contact/ - -.. _Report an issue on our bug tracker: https://github.com/owncloud/core/issues -.. _Junior Jobs: http://owncloud.org/dev/junior-jobs/ -.. _usability testing: http://jancborchardt.net/usability-in-free-software - -.. _git crash course: http://git-scm.com/course/svn.html - -.. _Twig Templates: http://twig.sensiolabs.org/ -.. _Symfony Routing: http://symfony.com/doc/current/components/routing/introduction.html -.. _Pimple: http://pimple.sensiolabs.org/ -.. _PHPUnit: http://www.phpunit.de/manual/current/en/ - diff --git a/developer_manual/testing/index.rst b/developer_manual/testing/index.rst new file mode 100644 index 000000000..5e09de023 --- /dev/null +++ b/developer_manual/testing/index.rst @@ -0,0 +1,7 @@ +======= +Testing +======= + +.. toctree:: + :maxdepth: 1 + diff --git a/developer_manual/translation/index.rst b/developer_manual/translation/index.rst new file mode 100644 index 000000000..4669cefcc --- /dev/null +++ b/developer_manual/translation/index.rst @@ -0,0 +1,8 @@ +=========== +Translation +=========== + +.. toctree:: + :maxdepth: 1 + +* `Translate `_ ownCloud to your language \ No newline at end of file