changelog shortlog tags branches files raw gz bz2 help

Mercurial > hg > werc / changeset: Many documentation changes and updates.

changeset 637: 0d80704bf0a2
parent 636: 9ab5110ba927
child 638: 246f5fab8f92
author: Uriel <u@berlinblue.org>
date: Fri, 11 Jun 2010 04:28:22 +0000
files: sites/werc.cat-v.org/development/index.md sites/werc.cat-v.org/development/roadmap.md sites/werc.cat-v.org/development/todo.md
description: Many documentation changes and updates.
     1.1--- a/sites/werc.cat-v.org/development/index.md	Sun Jun 06 18:06:21 2010 +0000
     1.2+++ b/sites/werc.cat-v.org/development/index.md	Fri Jun 11 04:28:22 2010 +0000
     1.3@@ -1,17 +1,15 @@
     1.4 Werc Development
     1.5 ================
     1.6 
     1.7-The latest dev code is available in the werc-dev hg repo: http://hg.cat-v.org/werc-dev/
     1.8+The latest dev code is available in the werc mercurial repo: http://hg.cat-v.org/werc/
     1.9 
    1.10-Release Numbering
    1.11------------------
    1.12 
    1.13-Releases with an od 'dot-number' (eg., 1.1.x) are development releases, they are hosted in the `werc-dev` hg repo.
    1.14+Version Numbering and Branching Rules
    1.15+-------------------------------------
    1.16 
    1.17-Releases with an even 'dot-number' (eg., 1.2.x) are stable releases, only receive bug fixes, they are hosted in the `werc` hg repo.
    1.18+There is no such thing! Originally a convention similar to that of the Linux kernel was used, but it is easier to do incremental work on a single branch.
    1.19 
    1.20-Major non-backwards compatible changes are only made in major release numbers (eg., 2.0).
    1.21-
    1.22+For radical or experimental changes the `werc-dev` branch might be used, but at the moment it is outdated.
    1.23 
    1.24 Bug reports, feature requests, bug fixes and other patches are all very welcome, just send them to the [werc9](http://groups.google.com/group/werc9) mailing list.
    1.25 
     2.1--- a/sites/werc.cat-v.org/development/roadmap.md	Sun Jun 06 18:06:21 2010 +0000
     2.2+++ b/sites/werc.cat-v.org/development/roadmap.md	Fri Jun 11 04:28:22 2010 +0000
     2.3@@ -1,9 +1,21 @@
     2.4 Development Roadmap
     2.5 ===================
     2.6 
     2.7-Werc 1.3.x
     2.8+The versioning scheme is a mess, originally even minor version numbers were
     2.9+supposed to be stable and odd ones development branches, but turns out that for
    2.10+the most part it is easier to do incremental development instead of keeping
    2.11+'dev' and 'stable' branches.
    2.12+
    2.13+A development branch might be added in the future if the changes are radical
    2.14+enough and break backwards compatibility in some important way. For this the
    2.15+deprecated and currently outdated `werc-dev` mercurial repo will be used.
    2.16+
    2.17+
    2.18+Werc 1.5.x
    2.19 ----------
    2.20 
    2.21+Planed major changes in 1.5
    2.22+
    2.23 * Include required p9p binaries in standard distribution (or with some easy to deploy packaging).
    2.24 * New/rewritten css layout, perhaps using fluid960gs? 
    2.25 * File upload support [*Code contributed by maht, needs integration*]
    2.26@@ -11,14 +23,20 @@
    2.27 * More complete test suite.
    2.28 
    2.29 
    2.30-Werc 1.2.x, current stable branch
    2.31+Werc 1.4.x, current stable branch
    2.32 ---------------------------------
    2.33 
    2.34-* Only bugfixes.
    2.35+* Mostly bugfixes, documentation work, and minor improvements.
    2.36 
    2.37 
    2.38-Werc 1.1.x previous dev branch
    2.39-------------------------------
    2.40+Werc 1.2.x, previous stable branch
    2.41+----------------------------------
    2.42+
    2.43+* Only security fixes.
    2.44+
    2.45+
    2.46+Werc 1.1.x dev branch
    2.47+---------------------
    2.48 
    2.49 * Convert all templates and pages to HTML 5. [*Done*]
    2.50 * Include new markdown implementation in pure awk by yuyis.[*Done*]
    2.51@@ -27,10 +45,10 @@
    2.52 * Include test suite/site (also to be hosted at http://tst.cat-v.org) [*In Progress*]
    2.53 
    2.54 
    2.55-Werc 1.0.x, previous stable branch
    2.56-----------------------------------
    2.57+Werc 1.0.x
    2.58+----------
    2.59 
    2.60-* Only security fixes.
    2.61+* Abandoned, please upgrade.
    2.62 
    2.63 
    2.64 -----------------------------------------------------
     3.1--- a/sites/werc.cat-v.org/development/todo.md	Sun Jun 06 18:06:21 2010 +0000
     3.2+++ b/sites/werc.cat-v.org/development/todo.md	Fri Jun 11 04:28:22 2010 +0000
     3.3@@ -1,6 +1,13 @@
     3.4-Plans and ideas for the future
     3.5+Plans and Ideas for the Future
     3.6 ==============================
     3.7 
     3.8+This page lists various assorted ideas and features that have been proposed at
     3.9+some point or another, nothing (except fixing the listed bugs) is assured to be
    3.10+implemented, many things here might turn out to be bad ideas.
    3.11+
    3.12+Features
    3.13+--------
    3.14+
    3.15 * Review ideas from: http://www.w3.org/TR/chips/ and http://www.w3.org/Provider/Style/URI and see if we can do better.
    3.16 * Canonize and redirect all requests, we already do this for things like missing or trailing /, should do the same for /. and /./, etc. Deleting trailing . and , should make pasted urls in emails work as links (**Mostly done in RC1**)
    3.17 * Blog:
    3.18@@ -12,13 +19,14 @@
    3.19 * Layout improvements:
    3.20 	* Need to find a way to rig the order of items in the sidebar.
    3.21 	* Right sidebar.
    3.22+    * Top+left/right nav vars (breadcrumbs at the top, current dir listing on the side)
    3.23 	* Make it easier to disable all sidebars and headers/footers, eg., for full screen mode.
    3.24 	* More testing and optimizations for mobile browsers, eg., http://www.operamini.com/demo/ Left sidebar had some minor issues in cellphones at some point.
    3.25-* Better page titles (include whole path hierarchy?)
    3.26+* Better page titles (include whole path hierarchy?) (**Partially done, is it good enough now?**)
    3.27 * Allow utf-8 characters in path elements (need to make sure this is safe, and not sure how useful it will be)
    3.28 * General code:
    3.29-	* Write a regression test suite
    3.30-	* Replace all references to non p9p/p9 programs (done?)
    3.31+	* Write a regression test suite. (*Started*)
    3.32+	* Replace all references to non p9p/p9 programs (*Done?*)
    3.33 	* Document better the 'API' for sub-apps, both a set of environment vars apps can rely on (and in some cases set) and functions they can call (WIP).
    3.34 * Better generation of descriptive HTML META tags, eg.,: {META name="description" content="This is the Google Summer of Code blog for Plan9 and Inferno projects."} {META name="keywords" content="google, summer of code, inferno, plan9, programming"}
    3.35 * Should add werc to certain wikipedia lists:
    3.36@@ -28,13 +36,13 @@
    3.37 * Mathematic pseudo-CAPTCHA ala WP's 'Math Comment Spam Protection Plugin'.
    3.38 
    3.39 
    3.40-Future plans
    3.41-------------
    3.42+Future Plansi and Blue Sky
    3.43+--------------------------
    3.44 
    3.45-* Wanted apps:
    3.46+* Wanted [apps](/apps/):
    3.47 	* Tagging, eg., append to _werc/tags
    3.48 	* Related links sidebar generation.
    3.49-	* Bug/issue tracking app.
    3.50+	* [Bug/issue tracking app](/apps/gregor/).
    3.51 	* Hg/git repository browser.
    3.52 	* Implement AtomPub.
    3.53 
    3.54@@ -42,7 +50,7 @@
    3.55 * A way to wrap external cgi applications (eg., existing hg/git browser)
    3.56 * A way to generate static sites (ie., use werc as an offline  templating system)
    3.57 * [9P](http://9p.cat-v.org) interface.
    3.58-* New (simplified) markdown implementation, ideally in C or awk (maybe smu/libsmu by gottox?):
    3.59+* New (simplified) markdown implementation, ideally in C or awk (maybe smu/libsmu by gottox?), yiyus great md2html.awk is a great start!
    3.60   * Simplified
    3.61   * Tables
    3.62   * Images
    3.63@@ -50,9 +58,18 @@
    3.64   * No inline html
    3.65 
    3.66 
    3.67-Known bugs
    3.68+Known Bugs
    3.69 ----------
    3.70 
    3.71+* It seems that certain chars are not propely encoded in cookies, possibly broken chars: :&%[+ Fix should go in cgilib.rc^set_cookie (Have to figure out the proper way to scape cookie strings first)
    3.72+* If a dir under apps/ doesn't contain an app.rc file, werc fails to start. A possible fix would be to replace $werc_apps default with `apps/*/app.rc` instead of `apps/*/`, this would be backwards incompatible, but I doubt anyone uses that option.
    3.73+* Links in Blagh feeds become confused if markdown 'references' are used, markdown references suck, but I guess we need to address this somehow... 
    3.74+* Somewhat similarly to the abouve, relative urls in imgs, links, etc. can easily break when used in Blagh posts, so it is not all markdown's fault.
    3.75+
    3.76+
    3.77+Fixed or WFM Bugs
    3.78+-----------------
    3.79+
    3.80 * Sitemap can handle $dirfilter inconsistently from other places (**fixed**).
    3.81 * Finding directories that are inaccessible (-rx) can generate an infinite loop (**Works for me? Fixed with new menu code?**)
    3.82 * Some cat-v.org bits still left over here and there, should make them configurable (1.0 blocker) (**fixed**?)