Clean the README a little bit

Notably, remove a section that was just describing the workflow that is now
used by 99% of people, thanks to github and co. People now how to do these
things nowadays.
This commit is contained in:
louiz’ 2018-08-23 23:50:29 +02:00
parent 4463a0d5b5
commit 2a75589747

View file

@ -1,13 +1,5 @@
:: poezio
======
_
(_)
_ __ ___ ___ _____ ___
| '_ \ / _ \ / _ \_ / |/ _ \
| |_) | (_) | __// /| | (_) |
| .__/ \___/ \___/___|_|\___/
| |
|_|
Homepage: https://poez.io Homepage: https://poez.io
@ -25,9 +17,8 @@ Jabber client, but still MultiUserChats-centered.
In the future, poezio should implement at a 100% level all XEP related to In the future, poezio should implement at a 100% level all XEP related to
MUCs, especially XEP 0045. MUCs, especially XEP 0045.
======================= Install
Install =======
=======================
You need python 3.5 or higher (preferably the latest) and the associated devel You need python 3.5 or higher (preferably the latest) and the associated devel
package, to build C modules, and the slixmpp python library. package, to build C modules, and the slixmpp python library.
@ -66,25 +57,22 @@ talk to us directly on our Jabber chat room (see Contact section).
Please DO report any bug you encounter and ask for any feature you want Please DO report any bug you encounter and ask for any feature you want
(we may implement it or not, but its always better to ask). (we may implement it or not, but its always better to ask).
======================= Authors
Authors =======
=======================
- Florent Le Coz (louiz) <louiz@louiz.org> (developer) - Florent Le Coz (louiz) <louiz@louiz.org> (developer)
- Mathieu Pasquet (mathieui) <mathieui@mathieui.net> (developer) - Mathieu Pasquet (mathieui) <mathieui@mathieui.net> (developer)
- Emmanuel Gil Peyrot (Link Mauve) <linkmauve@linkmauve.fr> (developer) - Emmanuel Gil Peyrot (Link Mauve) <linkmauve@linkmauve.fr> (developer)
======================= Contact/support
Contact/support ===============
=======================
Jabber ChatRoom: `poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_ Jabber ChatRoom: `poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_
Report a bug: https://dev.poez.io/new Report a bug: https://dev.poez.io/new
======================= License
License =======
=======================
Poezio is Free Software. Poezio is Free Software.
(learn more: http://www.gnu.org/philosophy/free-sw.html) (learn more: http://www.gnu.org/philosophy/free-sw.html)
@ -96,58 +84,22 @@ The artwork logo was made by Gaëtan Ribémont and released under
the Creative Commons BY license (http://creativecommons.org/licenses/by/2.0/) the Creative Commons BY license (http://creativecommons.org/licenses/by/2.0/)
======================= Hacking
Hacking =======
=======================
If you want to contribute, you will be welcome on If you want to contribute, you will be welcome on
`poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_ to announce your `poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_ to announce your
ideas, what you are going to do, or to seek help if you have trouble ideas, what you are going to do, or to seek help if you have trouble
understanding some of the code. understanding some of the code.
The preferred way to submit changes is through a public git repository. The preferred way to submit changes is through a merge request on gitlab,
But mercurial repositories or simple patches are also welcome. at https://lab.louiz.org/poezio/poezio, but we also accept contributions
on github, or with a simple “please fetch my code on my personal git
For contributors having commit access: repository hosted somewhere”
This section explains how the git repository is organized.
The “master” branch is the branch where all recent development is made. This is
the unstable version, which can be broken, but we should try to keep it usable
and crash-free as much as possible (so, never push to it if you are adding a
*known* crash).
New big features that take time to be complete should be developed in feature
branches (for example the “plugins” or the “opt” branches).
If its a really long feature, merge the “master” branch in that feature branch
from time to time, to avoid huge merges (and merge issues) when youll have to
merge your feature back in “master”.
Merge your work in master once it works and is usable, not necessarily when
its 100% finished. Polishing and last bug fixes can take place in “master”.
Conflicts should be solved with *rebase* and not with merge. This means
that if two developers commited one thing at the same time in their own
repository, the first pushes on the public public repos, and the other
has to pull before being able to push too. In that case, the second
developer should use the rebase command instead of merge. This avoids
creating unnecessary “branches” and visible merges.
On the contrary, when merging feature branches back to “master”, we should
use merge with the --no-ff tag (this makes sure the branch will always
distinctly appear in the logs), even if no conflict occured.
Finally, when a release is ready, we should merge the “master” branch
into the releases branch, then tag it to that version number.
If an “urgent” bugfix has to be made for a release (for example
a security issue is discovered on the last stable version, and
the current master has evolved too much to be released in the current
state), we create a new bugfix branch from the “releases” branch, we fix
it and finally merge it back to the “releases” branch, and tag it (and
we merge it to “master” as well, of course).
======================= Thanks
Thanks ======
=======================
- People: - People:
- Todd Eisenberger - Plugin system and OTR support - Todd Eisenberger - Plugin system and OTR support