Google Git
Sign in
apache / forrest / refs/tags/forrest_09_release_site / . / todo.html
blob: be356ba4e23f7b9b7c24c71801c5ebb1e1f48a1e [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
<meta name="Forrest-version" content="0.9-dev">
<meta name="Forrest-skin-name" content="pelt">
<title>Todo List</title>
<link type="text/css" href="skin/basic.css" rel="stylesheet">
<link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
<link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
<link type="text/css" href="skin/profile.css" rel="stylesheet">
<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
<link rel="shortcut icon" href="favicon.ico">
</head>
<body onload="init()">
<script type="text/javascript">ndeSetTextSize();</script>
<div id="top">
<!--+
|breadtrail
+-->
<div class="breadtrail">
<a href="http://www.apache.org/">Apache Software Foundation</a> &gt; <a href="http://forrest.apache.org/">Apache Forrest</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
</div>
<!--+
|header
+-->
<div class="header">
<!--+
|start group logo
+-->
<div class="grouplogo">
<a href="http://www.apache.org/"><img class="logoImage" alt="Apache" src="images/apache-forrest.png" title="The Apache Software Foundation"></a>
</div>
<!--+
|end group logo
+-->
<!--+
|start Project Logo
+-->
<div class="projectlogo">
<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="images/project-logo.gif" title="Apache Forrest"></a>
</div>
<!--+
|end Project Logo
+-->
<!--+
|start Search
+-->
<div class="searchbox">
<form action="http://www.google.com/search" method="get" class="roundtopsmall">
<input value="forrest.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp;
<input name="Search" value="Search" type="submit">
</form>
</div>
<!--+
|end search
+-->
<!--+
|start Tabs
+-->
<ul id="tabs">
<li>
<a class="unselected" href="index.html">Welcome</a>
</li>
<li class="current">
<a class="selected" href="contrib.html">Developers</a>
</li>
<li>
<a class="unselected" href="versions/index.html">Versioned Docs</a>
</li>
<li>
<a class="unselected" href="pluginDocs/index.html">Plugins</a>
</li>
<li>
<a class="unselected" href="tools/index.html">Tools</a>
</li>
</ul>
<!--+
|end Tabs
+-->
</div>
</div>
<div id="main">
<div id="publishedStrip">
<!--+
|start Subtabs
+-->
<div id="level2tabs"></div>
<!--+
|end Endtabs
+-->
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<!--+
|breadtrail
+-->
<div class="breadtrail">
&nbsp;
</div>
<!--+
|start Menu, mainarea
+-->
<!--+
|start Menu
+-->
<div id="menu">
<div onclick="SwitchMenu('menu_1.1', 'skin/')" id="menu_1.1Title" class="menutitle">Getting involved</div>
<div id="menu_1.1" class="menuitemgroup">
<div class="menuitem">
<a href="contrib.html" title="Everyone is a developer and has something to contribute">Contributing</a>
</div>
<div class="menuitem">
<a href="mail-lists.html" title="Discussion mail lists are the heart of the project: dev, user, svn">Mail lists and discussion</a>
</div>
<div class="menuitem">
<a href="issues.html" title="Issue tracker manages known issues and desired enhancements">Reporting bugs and issues</a>
</div>
<div class="menuitem">
<a href="forrest-friday.html" title="ForrestFriday monthly get-together">ForrestFriday IRC</a>
</div>
<div class="menuitem">
<a href="events.html" title="List of upcoming related conferences and meetings">Events</a>
</div>
<div onclick="SwitchMenu('menu_1.1.6', 'skin/')" id="menu_1.1.6Title" class="menutitle">Project</div>
<div id="menu_1.1.6" class="menuitemgroup">
<div class="menuitem">
<a href="guidelines.html" title="Open development guidelines to encourage participation">Project guidelines</a>
</div>
<div class="menuitem">
<a href="committed.html" title="Notes about contribution">Being committed</a>
</div>
<div class="menuitem">
<a href="tasks.html" title="Tasks to keep the project flowing">Project tasks</a>
</div>
</div>
</div>
<div onclick="SwitchMenu('menu_selected_1.2', 'skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Resources and Infrastructure</div>
<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
<a href="asf-infrastructure.html" title="Explain the ASF infrastructure">Introduction</a>
</div>
<div class="menuitem">
<a href="mail-lists.html" title="Discussion mail lists are the heart of the project: dev, user, svn">Mail lists</a>
</div>
<div class="menuitem">
<a href="issues.html" title="Issue tracker manages known issues and desired enhancements">Issue management</a>
</div>
<div class="menuitem">
<a href="svn.html" title="Access to the Subversion (SVN) version control system">Version control</a>
</div>
<div class="menuitem">
<a href="http://forrest.zones.apache.org/" title="Demonstrations and testbed at forrest.zones.apache.org">Demonstrations</a>
</div>
<div class="menuitem">
<a href="gump.html">Gump integration</a>
</div>
<div onclick="SwitchMenu('menu_1.2.7', 'skin/')" id="menu_1.2.7Title" class="menutitle">Planning notes</div>
<div id="menu_1.2.7" class="menuitemgroup">
<div class="menuitem">
<a href="plan/index.html">Overview</a>
</div>
<div class="menuitem">
<a href="plan/internal-xhtml.html">Internal XHTML</a>
</div>
</div>
<div class="menupage">
<div class="menupagetitle">Todo</div>
</div>
</div>
<div onclick="SwitchMenu('menu_1.3', 'skin/')" id="menu_1.3Title" class="menutitle">Best Practices and Procedures</div>
<div id="menu_1.3" class="menuitemgroup">
<div class="menuitem">
<a href="howto-dev.html" title="Describes tips and procedures for efficiently developing with Forrest.">Development tips</a>
</div>
<div class="menuitem">
<a href="howto-forrestbot-svn.html" title="Publish documentation with Forrestbot svn workstage">Forrestbot svn</a>
</div>
<div class="menuitem">
<a href="howto-forrestbot-scp.html" title="Publish documentation with Forrestbot scp workstage">Forrestbot scp</a>
</div>
<div class="menuitem">
<a href="subversion_bestpractices.html" title="Best practice notes for Subversion">Subversion</a>
</div>
<div class="menuitem">
<a href="documentation_bestpractices.html" title="Best practice notes for documentation">Documentation</a>
</div>
<div class="menuitem">
<a href="howto-howto.html" title="Instructions for writing a new howto-document">Write a How-to</a>
</div>
<div onclick="SwitchMenu('menu_1.3.7', 'skin/')" id="menu_1.3.7Title" class="menutitle">Committer notes</div>
<div id="menu_1.3.7" class="menuitemgroup">
<div class="menuitem">
<a href="zone.html" title="Notes for committers to manage forrest.zones.apache.org">Zone management</a>
</div>
<div class="menuitem">
<a href="procedures/release/How_to_release.html" title="Instructions on preparing and creating a new Forrest release.">How to release</a>
</div>
<div class="menuitem">
<a href="procedures/How_to_publish_docs.html" title="Instructions on publishing the Forrest Website">Publishing Forrest documentation</a>
</div>
</div>
</div>
<div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Proposals</div>
<div id="menu_1.4" class="menuitemgroup">
<div class="menuitem">
<a href="proposal-asf-forrestbot.html">ASF Forrestbot</a>
</div>
</div>
<div id="credit"></div>
<div id="roundbottom">
<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
<!--+
|alternative credits
+-->
<div id="credit2">
<a href="http://www.apache.org/events/current-event.html"><img border="0" title="ApacheCon" alt="ApacheCon - logo" src="http://www.apache.org/events/current-event-125x125.png" style="width: 125px;height: 125px;"></a>
</div>
</div>
<!--+
|end Menu
+-->
<!--+
|start content
+-->
<div id="content">
<div class="trail">Font size:
&nbsp;<input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
&nbsp;<input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
&nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
</div>
<h1>Todo List</h1>
<div id="front-matter">
<div id="minitoc-area">
<ul class="minitoc">
<li>
<a href="#high">high</a>
</li>
<li>
<a href="#medium">medium</a>
</li>
<li>
<a href="#low">low</a>
</li>
</ul>
</div>
</div>
<a name="high"></a>
<h2 class="underlined_10">high</h2>
<div class="section">
<ul>
<li>
<strong>[code]</strong>
<!-- Please leave this action at the top -->
Please see our Jira
<a href="issues.html">issue tracker</a> for tasks to be done.
Note that the Todo list below is old. We need someone to move those
tasks over to the issue tracker.
&rarr; open</li>
<li>
<strong>[code]</strong>
Rework the menu generation system to make it more flexible. See thread
<a href="http://marc.theaimsgroup.com/?w=2&amp;r=1&amp;s=Fixing+menus&amp;q=t">Fixing
menus</a>
&rarr; open</li>
<li>
<strong>[code]</strong>
Define an 'object model' for Forrest sites, in the form of a Cocoon
pipeline, that defines
- The directory structure of a site
- Site metadata (what currently lives in skinconf.xml + gump.xml
stuff)
- Perhaps site.xml metadata for pages?
This info can then be made public to the sitemap (via XMLFileModule
attributes) and the stylesheets (through
<span class="codefrag">document(cocoon:/...)</span> calls or inlined with source XML).
&rarr; open</li>
<li>
<strong>[code]</strong>
Finalise the project-definition DTDs, like status.xml and module.xml;
try to come up with a common format with others on community.at.apache.org.
&rarr; NKB</li>
</ul>
</div>
<a name="medium"></a>
<h2 class="underlined_10">medium</h2>
<div class="section">
<ul>
<li>
<strong>[code]</strong>
Finish the RSS feed for status.xml.
Aggregate status.xml and project.xml to have all needed project data.
&rarr; NKB</li>
<li>
<strong>[docs]</strong>
Add stylesheets to render the enhanced status.xml file contents.
&rarr; open</li>
<li>
<strong>[code]</strong>
In skinconf.xml, change 'disable-search' to 'enable-search'.
&rarr; JT</li>
<li>
<strong>[code]</strong>
Enhance the initial forrest toolbar for Mozilla.
See email discussion <a href="http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=102471820523388">draft forrest toolbar for Mozilla</a>.
&rarr; NKB</li>
<li>
<strong>[code]</strong>
Fix things so docs can be edited in src/*, and have the changes appear
immediately in the webapp. Involves creating/using an InputModule for
passing 'forrest.skin' and other properties to the sitemap, so we can
avoid the @skin@ hack, and a bit of forrest.build.xml hacking. There
are some @tokens@ in a forrest-site CSS file that also need some sort
of in-place modification. Perhaps a @token@-to-value Transformer could
be the same ${variable}-to-value Transformer mentioned in the RT [3].
&rarr; open</li>
<li>
<strong>[code]</strong>
Act on <a href="http://marc.theaimsgroup.com/?t=104099660500001&amp;r=1&amp;w=2">'Entities in XML docs' RT</a>.
I can implement Stefano's
suggested solution quite easily, but is such limited functionality
worth the cost of introducing a proprietary ${variable} syntax? Maybe..
Best short-term alternative seems to be using the XNI XInclude
processor for pre-validation inclusion.
&rarr; open</li>
<li>
<strong>[docs]</strong>
A lot of the info on the website is outdated.
&rarr; open</li>
<li>
<strong>[docs]</strong>
Using metadata
from site.xml, it would at least be possible to indicate how old the
doc is, and perhaps indicate its relevance from a small controlled
vocabulary.
&rarr; open</li>
<li>
<strong>[design]</strong>
Develop a mechanism for supporting legacy URLs.
See email discussion -
<a href="http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=102390892524750">redirects with static sites</a>
&rarr; open</li>
<li>
<strong>[code]</strong>
Fix up and integrate the Forrest Maven plugin.
&rarr; open</li>
</ul>
</div>
<a name="low"></a>
<h2 class="underlined_10">low</h2>
<div class="section">
<ul>
<li>
<strong>[code]</strong>
Ensure that PHP-like stuff can be embedded easily in Forrest files and
document it.
&rarr; open</li>
<li>
<strong>[code]</strong>
Continue the development of the <a href="docs_0_70/libre-intro.html">Libre</a> facility - replacement for
*/book.xml
&rarr; open</li>
<li>
<strong>[docs]</strong>
Start a community doc where we list tools such as "code".
&rarr; open</li>
<li>
<strong>[code]</strong>
Migrate to a decent schema language, primarily so that we can use
namespaces in XML docs, allowing things like XInclude,
<a href="http://www.xml.com/pub/a/2002/10/30/rdf-friendly.html">in-line metadata</a>,
in-line SVG, Jelly snippets, or anything else users can make a
Transformer for.
&rarr; open</li>
<li>
<strong>[code]</strong>
Streamline the process of adding support for new schemas. Ideally we'd
have an auto-download system, e.g. 'forrest-update docbook' would fetch
and install the Docbook DTDs, create catalog entries, sitemap mods etc.
&rarr; open</li>
<li>
<strong>[code]</strong>
Make a CSS Generator and a stylesheet to serialize it to text.
&rarr; NKB</li>
<li>
<strong>[docs]</strong>
Add a document about authoring in XML for beginners..
&rarr; open</li>
</ul>
</div>
</div>
<!--+
|end content
+-->
<div class="clearboth">&nbsp;</div>
</div>
<div id="footer">
<!--+
|start bottomstrip
+-->
<div class="lastmodified">
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<div class="copyright">
Copyright &copy;
2002-2011 <a href="http://www.apache.org/licenses/">The Apache Software Foundation. Licensed under Apache License 2.0</a>
<br>
Apache, Apache Forrest, the Apache feather logo, and the Apache Forrest
logos are trademarks of The Apache Software Foundation.
</div>
<!--+
|end bottomstrip
+-->
</div>
</body>
</html>