changelog shortlog tags branches changeset files file revisions raw help

Mercurial > hg > werc / annotate sites/

changeset 637: 0d80704bf0a2
parent: 21e746da4719
child: 8704f5149b91
author: Uriel <>
date: Fri, 11 Jun 2010 04:28:22 +0000
permissions: -rw-r--r--
description: Many documentation changes and updates.
u@637 1
 Plans and Ideas for the Future
uriel@386 2
uriel@386 3
u@637 4
 This page lists various assorted ideas and features that have been proposed at
u@637 5
 some point or another, nothing (except fixing the listed bugs) is assured to be
u@637 6
 implemented, many things here might turn out to be bad ideas.
u@637 7
u@637 8
u@637 9
u@637 10
uriel@408 11
 * Review ideas from: and and see if we can do better.
uriel@483 12
 * 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**)
uriel@391 13
 * Blog:
uriel@391 14
 	* Comment threading.
uriel@576 15
 	* Some form of pagination (taking advantage of history browsing.) (**Partially done**)
uriel@391 16
 * Sitemaps:
uriel@391 17
 	* Index pages should be used for description of directories.
uriel@483 18
 	* Cache web sitemap generation. (**Done in RC0**)
uriel@391 19
 * Layout improvements:
uriel@391 20
 	* Need to find a way to rig the order of items in the sidebar.
uriel@391 21
 	* Right sidebar.
u@637 22
     * Top+left/right nav vars (breadcrumbs at the top, current dir listing on the side)
uriel@391 23
 	* Make it easier to disable all sidebars and headers/footers, eg., for full screen mode.
u@621 24
 	* More testing and optimizations for mobile browsers, eg., Left sidebar had some minor issues in cellphones at some point.
u@637 25
 * Better page titles (include whole path hierarchy?) (**Partially done, is it good enough now?**)
uriel@391 26
 * Allow utf-8 characters in path elements (need to make sure this is safe, and not sure how useful it will be)
uriel@391 27
 * General code:
u@637 28
 	* Write a regression test suite. (*Started*)
u@637 29
 	* Replace all references to non p9p/p9 programs (*Done?*)
uriel@391 30
 	* 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).
uriel@391 31
 * 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"}
uriel@391 32
 * Should add werc to certain wikipedia lists:
u@621 33
 	* ``
u@621 34
 	* ``
uriel@444 35
 * Include txt2tags as builtin alternative to markdown.
uriel@533 36
 * Mathematic pseudo-CAPTCHA ala WP's 'Math Comment Spam Protection Plugin'.
uriel@391 37
uriel@391 38
u@637 39
 Future Plansi and Blue Sky
u@637 40
uriel@391 41
u@637 42
 * Wanted [apps](/apps/):
uriel@391 43
 	* Tagging, eg., append to _werc/tags
uriel@391 44
 	* Related links sidebar generation.
u@637 45
 	* [Bug/issue tracking app](/apps/gregor/).
uriel@391 46
 	* Hg/git repository browser.
uriel@391 47
 	* Implement AtomPub.
uriel@391 48
uriel@391 49
 * Further modularization and extensibility (meta-templates) (Is the new app framework enough for this?)
uriel@391 50
 * A way to wrap external cgi applications (eg., existing hg/git browser)
uriel@391 51
 * A way to generate static sites (ie., use werc as an offline  templating system)
uriel@391 52
 * [9P]( interface.
u@637 53
 * New (simplified) markdown implementation, ideally in C or awk (maybe smu/libsmu by gottox?), yiyus great md2html.awk is a great start!
uriel@391 54
   * Simplified
uriel@391 55
   * Tables
uriel@391 56
   * Images
uriel@391 57
   * Autogenerated anchors/navigation boxes
uriel@391 58
   * No inline html
uriel@391 59
uriel@391 60
u@637 61
 Known Bugs
uriel@391 62
uriel@391 63
u@637 64
 * 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)
u@637 65
 * 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.
u@637 66
 * Links in Blagh feeds become confused if markdown 'references' are used, markdown references suck, but I guess we need to address this somehow... 
u@637 67
 * 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.
u@637 68
u@637 69
u@637 70
 Fixed or WFM Bugs
u@637 71
u@637 72
uriel@408 73
 * Sitemap can handle $dirfilter inconsistently from other places (**fixed**).
uriel@483 74
 * Finding directories that are inaccessible (-rx) can generate an infinite loop (**Works for me? Fixed with new menu code?**)
uriel@408 75
 * Some bits still left over here and there, should make them configurable (1.0 blocker) (**fixed**?)