Ladsgroup has submitted this change and it was merged.
Change subject: Overhaul README file with more information ......................................................................
Overhaul README file with more information
Now includes how to install the framework, a simple code snippet, and a link on how to contribute patches.
Change-Id: I112b53e0a2a3767e459323a34dc012ccc05201bd --- M README.md 1 file changed, 30 insertions(+), 6 deletions(-)
Approvals: Ladsgroup: Verified; Looks good to me, approved
diff --git a/README.md b/README.md index 3592013..7acbc43 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,34 @@ -# Python Wikipedia Robot Framework +# Pywikibot Framework
[![Build Status](https://secure.travis-ci.org/wikimedia/pywikibot-core.png?branch=master)%5D(...)
-This is the rewrite of the Python Wikipedia Robot Framework. It features several -improvements, such as full API usage and a pythonic package layout. +The pywikibot framework is a Python library that interfaces with the [MediaWiki API](https://www.mediawiki.org/wiki/API). +Also included are various general function scripts that can be adapted for different tasks.
-If you want to run the rewrite as a stand-alone package, please also download the -the contents of the externals/ subdirectory. Confer externals/README for more -information. +## Quick start +``` +git clone https://gerrit.wikimedia.org/r/pywikibot/core.git +cd core +git submodule update --init +python pwb.py script_name +``` + +Our [installation guide](https://www.mediawiki.org/wiki/Manual:Pywikipediabot/Installation) has more details for advanced usage. + +## Usage + +If you wish to write your own script it's very easy to get started: + +```python +import pywikibot +site = pywikibot.Site('en', 'wikipedia') # The site we want to run our bot on +page = pywikibot.Page(site, 'Wikipedia:Sandbox') +text = page.get() # The current text on the page +text = text.replace('foo', 'bar') +page.put(text, 'Replacing "foo" with "bar"') # Saves the page +``` + +## Contributing + +Our code is maintained on Wikimedia's [Gerrit installation](https://gerrit.wikimedia.org/), [learn](https://www.mediawiki.org/wiki/Developer_access) how to get started. +
pywikibot-commits@lists.wikimedia.org