On Sat, Mar 28, 2015 at 09:36:50PM -0400, Jefry Lagrange wrote:
Hello everyone,
I found myself thinking about the process of proposing and editing xeps that
the xsf implements. I think there are some improvements that could be made
in order to make the process easier.
These are the main areas which I think are problematic with the current way
of doing things:
* git has a learning curve.
* xml has a learning curve.
* scripts are necessary to convert the xml to readable documents.
* Everything is tracked in the same project (scripts, templates,
xeps). XEPs aren't tracked as individual projects.
These problems aren't that grave, after all, most of us are developers.
However, I think it is worthwhile to explore alternatives to make it easier.
I spent the past week working on a wiki page that closely resembles the look
and feel of xeps.
Here is the url: http://jlagrange.net/wiki/index.php/Category:Extensions
In that week, I learned that by developing your own mediawiki skins and
extensions, you are able to make a wiki look however you like.
Because wikis were made specifically to track and modify documents, they
have some features could be useful for us.
* view and compare history of changes online
* user management to allow authors to modify their xeps and nothing
more. Or to allow trusted users to help Peter.
* rss of changes
* easier to edit and see the results without using scripts to convert
it to html
* discussion pages for each xep
At the very least it could serve a way to make quick prototypes and get
feedback.
Hello Jefry,
Making the XEP creation/edition process more accessible is a worthwhile
endeavour in my opinion. However, while the wiki format does have its
uses and advantages, I am not sure it would be a great fit for XEPs.
I want to address several points:
- git has a learning curve: yes, but git is not required at all for
proposing and editing xeps, you only need to clone the repo and
everything afterwards can be done without git.
- XML has a learning curve, but I would argue that people submitting
XMPP extensions are already past the required level ;). More to the
point, the only XML required while writing a XEP is some bare-bones
XHTML, and writing the metadata.
- Everything is tracked in the same project. Yes, I agree, but the
consensus seems to be that this isn’t an issue, as there aren’t too
many changes happening, and maintaining a separate history for each
XEP would be only more maintenance overhead, currently.
- XEPs already have online diffs
What I find lacking, or counter-intuitive, in a wiki-powered solution:
- The very ability to get all XEP sources in plain text, like we
currently can.
- Reviewing changes: wikis have this feature, but this would require to
create several pages per XEP, in order to have the author edit a copy
of the extension, then having people review them, and finally editors
can move the copy to the “final” page. This is important for the
publishing process, because non-editors shouldn’t be able to edit
published documents.
- Mandatory web interface (this is the biggest issue, for me), both for
reviews, discussions, and submissions
What I could appreciate in a wiki solution:
- RSS/Atom feeds of changes
- Centralized discussions: the mailing-list is nice to have exchanges,
but after some time it becomes gruesome to aggregate all that was said
on a particular extension.
- Possible web-based edition for quick edits to the documents, with
instant visual feedback.
(Please don’t think that I’m overly negative, I’m just writing down some
quick thoughts)
--
Mathieu Pasquet (mathieui)
pgpPpeL5bvUwL.pgp
Description: PGP signature