From 98143e8bbcecd2bf60451b571e629b293757658c Mon Sep 17 00:00:00 2001 From: Benjamin Brahmer Date: Tue, 1 Jun 2021 11:44:34 +0200 Subject: add admin docs page, document removal of command Signed-off-by: Benjamin Brahmer Co-authored-by: anoy. --- appinfo/info.xml | 2 +- docs/api/api-v1.md | 2 +- docs/developer.md | 22 ++++++++++++++++++++++ mkdocs.yml | 1 + 4 files changed, 25 insertions(+), 2 deletions(-) create mode 100644 docs/developer.md diff --git a/appinfo/info.xml b/appinfo/info.xml index 53eb1afce..2a4c17960 100644 --- a/appinfo/info.xml +++ b/appinfo/info.xml @@ -28,7 +28,7 @@ Report a [feed issue](https://github.com/nextcloud/news/discussions/new) https://nextcloud.github.io/news/ https://nextcloud.github.io/news/admin/ - https://nextcloud.github.io/news/ + https://nextcloud.github.io/news/developer multimedia https://github.com/nextcloud/news diff --git a/docs/api/api-v1.md b/docs/api/api-v1.md index fd39a8acd..fd7575e75 100644 --- a/docs/api/api-v1.md +++ b/docs/api/api-v1.md @@ -669,7 +669,7 @@ This is used to clean up the database. It deletes folders and feeds that are mar } ``` -**New in 8.1.0**: The console command for achieving the same result is: +**New in 8.1.0, Removed in 16.0.0**: The console command for achieving the same result is: php -f nextcloud/occ news:updater:all-feeds diff --git a/docs/developer.md b/docs/developer.md new file mode 100644 index 000000000..8a6bdd411 --- /dev/null +++ b/docs/developer.md @@ -0,0 +1,22 @@ +# Developer +Welcome to the Nextcloud News App developer documentation. + +News is open for contributions, if you plan to implement a new feature make sure to open a [discussion](https://github.com/nextcloud/news/discussions/new?category=Features). Describe the feature that you are planing and your first idea how to implement it. +This ensures that you don't start working on something which collides with the targets of the maintainers. + +For small fixes and improvements feel free to directly create a PR, the maintainers are happy to review your code. + +## APIs +News offers an API that can be used by clients to synchronize with the server. +There are two API declarations, so far only V1 has been fully implemented. +Work on V2 has started with low priority. + +- [API-V1](api/api-v1.md) +- [API-V2](api/api-v2.md) + +## Coding Style Guidelines +The PHP code should all adhere to [PSR-2](https://www.php-fig.org/psr/psr-2/). +*Note that this is a different codestyle than Nextcloud itself uses.* +To test the codestyle you can run `make phpcs`. + +For linting JavaScript, a [jshint file](https://github.com/nextcloud/news/blob/master/js/.jshintrc) is used that is run before compiling the JavaScript. diff --git a/mkdocs.yml b/mkdocs.yml index 96ab56f79..7da834736 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -10,6 +10,7 @@ nav: - install.md - clients.md - admin.md + - developer.md - faq.md - Features: - Custom CSS: features/customCSS.md -- cgit v1.2.3