From 94207cf8ea41132fd7279ab08845677542eb3c9f Mon Sep 17 00:00:00 2001 From: Frederic Guillot Date: Sat, 23 Jan 2016 10:52:55 -0500 Subject: [PATCH] Update doc and readme --- README.md | 41 ++++++++---------------- doc/api-examples.markdown | 66 ++++++++++----------------------------- doc/faq.markdown | 34 ++++++++++---------- 3 files changed, 46 insertions(+), 95 deletions(-) diff --git a/README.md b/README.md index 61730b775..ebfdc7677 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ Kanboard [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/fguillot/kanboard/badges/quality-score.png?s=2b6490781608657cc8c43d02285bfafb4f489528)](https://scrutinizer-ci.com/g/fguillot/kanboard/) [![SensioLabsInsight](https://insight.sensiolabs.com/projects/5e50750e-fc62-4a1f-b02a-71991123a2a7/mini.png)](https://insight.sensiolabs.com/projects/5e50750e-fc62-4a1f-b02a-71991123a2a7) -Kanboard is a project management software that uses the Kanban methodology. +Kanboard is a project management software that focus on the Kanban methodology. Official website: @@ -13,38 +13,23 @@ Official website: - Multiple boards with the ability to drag and drop tasks - Open source and self-hosted - Super simple installation -- Translated in 24 languages -- Distributed under [MIT License](LICENSE) -- [List of features are available on the website](http://kanboard.net/features) -- [Change Log](ChangeLog) +- Translated in many languages +- Distributed under [MIT License](https://github.com/fguillot/kanboard/blob/master/LICENSE) +- The complete [list of features are available on the website](http://kanboard.net/features) +- [Change Log](https://github.com/fguillot/kanboard/blob/master/ChangeLog) +- [Documentation](https://github.com/fguillot/kanboard/blob/master/doc/index.markdown) [![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy) -Known bugs and feature requests -------------------------------- - -- Bug tracker: - Authors ------- -- Main developer: Frédéric Guillot (fguillot) -- [List of contributors](CONTRIBUTORS.md) +- Main developer: [Frédéric Guillot](https://github.com/fguillot) +- [List of contributors](https://github.com/fguillot/kanboard/blob/master/CONTRIBUTORS.md) -Documentation -------------- +Installation and Upgrade +------------------------ -- [Read the documentation](doc/index.markdown) - -Related projects ----------------- - -List of plugins: http://kanboard.net/plugins - -- [Kanboard API python client by @freekoder](https://github.com/freekoder/kanboard-py) -- [Kanboard Presenter by David Eberlein](https://github.com/davideberlein/kanboard-presenter) -- [CSV2Kanboard by @ashbike](https://github.com/ashbike/csv2kanboard) -- [Kanboard for Yunohost by @mbugeia](https://github.com/mbugeia/kanboard_ynh) -- [Trello import script by @matueranet](https://github.com/matueranet/kanboard-import-trello) -- [Chrome extension by Timo](https://chrome.google.com/webstore/detail/kanboard-quickmenu/akjbeplnnihghabpgcfmfhfmifjljneh?utm_source=chrome-ntp-icon), [Source code](https://github.com/BlueTeck/kanboard_chrome_extension) -- [Python client script by @dzudek](https://gist.github.com/fguillot/84c70d4928eb1e0cb374) +- [Requirements](http://kanboard.net/documentation/requirements) +- [Installation instructions](http://kanboard.net/documentation/installation) +- [Upgrade to a new version](http://kanboard.net/documentation/update) diff --git a/doc/api-examples.markdown b/doc/api-examples.markdown index 9b1ed12a2..14d5db986 100644 --- a/doc/api-examples.markdown +++ b/doc/api-examples.markdown @@ -34,62 +34,30 @@ Response from the server: Example with Python ------------------- -Here a basic example written in Python to create a task: - -```python -#!/usr/bin/env python - -import requests -import json - -def main(): - url = "http://demo.kanboard.net/jsonrpc.php" - api_key = "be4271664ca8169d32af49d8e1ec854edb0290bc3588a2e356275eab9505" - headers = {"content-type": "application/json"} - - payload = { - "method": "createTask", - "params": { - "title": "Python API test", - "project_id": 1 - }, - "jsonrpc": "2.0", - "id": 1, - } - - response = requests.post( - url, - data=json.dumps(payload), - headers=headers, - auth=("jsonrpc", api_key) - ) - - if response.status_code == 401: - print "Authentication failed" - else: - result = response.json() - - assert result["result"] == True - assert result["jsonrpc"] - assert result["id"] == 1 - - print "Task created successfully!" - -if __name__ == "__main__": - main() -``` - -Run this script from your terminal: +You can use the [official Python client for Kanboard](https://github.com/kanboard/kanboard-api-python): ```bash -python jsonrpc.py -Task created successfully! +pip install kanboard ``` +Here an example to create a project and a task: + +```python +from kanboard import Kanboard + +kb = Kanboard("http://localhost/jsonrpc.php", "jsonrpc", "your_api_token") + +project_id = kb.create_project(name="My project") + +task_id = kb.create_task(project_id=project_id, title="My task title") +``` + +There are more examples on the [official website](https://github.com/kanboard/kanboard-api-python). + Example with a PHP client ------------------------- -I wrote a simple [Json-RPC Client/Server library in PHP](https://github.com/fguillot/JsonRPC), here an example: +You can use this [Json-RPC Client/Server library for PHP](https://github.com/fguillot/JsonRPC), here an example: ```php - - How to install Kanboard on Yunohost? ------------------------------------ @@ -107,6 +93,18 @@ How to install Kanboard on Yunohost? There is a [package to install Kanboard on Yunohost easily](https://github.com/mbugeia/kanboard_ynh). +Where can I find a list of related projects? +-------------------------------------------- + +- [Kanboard API python client by @freekoder](https://github.com/freekoder/kanboard-py) +- [Kanboard Presenter by David Eberlein](https://github.com/davideberlein/kanboard-presenter) +- [CSV2Kanboard by @ashbike](https://github.com/ashbike/csv2kanboard) +- [Kanboard for Yunohost by @mbugeia](https://github.com/mbugeia/kanboard_ynh) +- [Trello import script by @matueranet](https://github.com/matueranet/kanboard-import-trello) +- [Chrome extension by Timo](https://chrome.google.com/webstore/detail/kanboard-quickmenu/akjbeplnnihghabpgcfmfhfmifjljneh?utm_source=chrome-ntp-icon), [Source code](https://github.com/BlueTeck/kanboard_chrome_extension) +- [Python client script by @dzudek](https://gist.github.com/fguillot/84c70d4928eb1e0cb374) + + Are there some tutorials about Kanboard in other languages? -----------------------------------------------------------