htdocs/docproj: point people to wiki for current projects
Remove the file too... Reviewed by: bcr
This commit is contained in:
Eitan Adler
parent
d0e41b20c2
commit
c2fcaed181
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=51734
1 changed files with 0 additions and 193 deletions
|
|
@ -1,193 +0,0 @@
|
||||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
||||||
<!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
|
|
||||||
"http://www.FreeBSD.org/XML/share/xml/xhtml10-freebsd.dtd" [
|
|
||||||
<!ENTITY title "FreeBSD Documentation Project: Current projects">
|
|
||||||
|
|
||||||
<!ENTITY imagebase "&base;/gifs">
|
|
||||||
|
|
||||||
<!-- Status levels -->
|
|
||||||
<!ENTITY status.blank " ">
|
|
||||||
<!ENTITY status.blocked "<img src='&imagebase;/blocked.png' width='22' height='22' alt='Blocked'/>">
|
|
||||||
<!ENTITY status.done "<img src='&imagebase;/done.png' width='22' height='22' alt='Done'/>">
|
|
||||||
<!ENTITY status.new "<img src='&imagebase;/not_started.png' width='22' height='22' alt='Not Started'/>">
|
|
||||||
<!ENTITY status.n-a "<img src='&imagebase;/not_planned.png' width='22' height='22' alt='Not Planned'/>">
|
|
||||||
<!ENTITY status.wip "<img src='&imagebase;/in_progress.png' width='22' height='22' alt='In progress'/>">
|
|
||||||
]>
|
|
||||||
|
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
||||||
<head>
|
|
||||||
<title>&title;</title>
|
|
||||||
|
|
||||||
<cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body class="navinclude.docs">
|
|
||||||
|
|
||||||
<p>Here are the projects currently under way (or being actively
|
|
||||||
contemplated on the freebsd-doc mailing list).</p>
|
|
||||||
|
|
||||||
<p>If you think you can contribute to any of these, please do not
|
|
||||||
hesitate to stand up and be counted. You should talk to the
|
|
||||||
person responsible for that particular project, who can then bring you
|
|
||||||
up to speed on what is happening. If you have any ideas for a new
|
|
||||||
project then please email <a href="mailto:FreeBSD-doc@FreeBSD.org">
|
|
||||||
FreeBSD-doc@FreeBSD.org</a>.</p>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
<li><a href="#todo">Documentation TODO list</a></li>
|
|
||||||
<li><a href="#pr">Open documentation problem reports</a></li>
|
|
||||||
<li><a href="#handbook-index">Improve Handbook Index</a></li>
|
|
||||||
<li><a href="#slides">Contribute Advocacy Slides/Presentations</a></li>
|
|
||||||
<li><a href="#handbooksection">Write a section in the Handbook and/or FAQ</a></li>
|
|
||||||
<li><a href="#newpapers">Write some new Papers</a></li>
|
|
||||||
<li><a href="#cgiscripts">CGI Scripts</a></li>
|
|
||||||
<li><a href="#multilingualwebscripts">Multilingual Web scripts</a></li>
|
|
||||||
<li><a href="#translations">Translations of the FreeBSD Documentation</a></li>
|
|
||||||
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<a name="todo"></a>
|
|
||||||
<h3>Documentation TODO list</h3>
|
|
||||||
|
|
||||||
<p>The Documentation <a href="https://wiki.freebsd.org/DocIdeaList">TODO</a>
|
|
||||||
list is an
|
|
||||||
up-to-date list of documentation issues that should be resolved.
|
|
||||||
If you wish to help us to improve the FreeBSD
|
|
||||||
documentation set you should, at first, choose to work on one of
|
|
||||||
the TODO list items.</p>
|
|
||||||
|
|
||||||
<a name="pr"></a>
|
|
||||||
<h3>Open documentation problem reports</h3>
|
|
||||||
|
|
||||||
<p>Current FreeBSD problems reports are tracked using a Problem Reports
|
|
||||||
database.
|
|
||||||
|
|
||||||
You can <a
|
|
||||||
href="https://bugs.freebsd.org/bugzilla/buglist.cgi?product=Documentation&component=Documentation&resolution=---">view</a>
|
|
||||||
the open documentation problem reports.</p>
|
|
||||||
|
|
||||||
<a name="handbook-index"></a>
|
|
||||||
<h3>Improve Handbook Index</h3>
|
|
||||||
|
|
||||||
<p><b>Responsible:</b> FreeBSD-doc <<a
|
|
||||||
href="mailto:FreeBSD-doc@FreeBSD.org">FreeBSD-doc@FreeBSD.org</a>></p>
|
|
||||||
|
|
||||||
<p><b>Synopsis:</b> Many new sections have been added to the
|
|
||||||
FreeBSD Handbook without index terms, others have been added
|
|
||||||
under inappropriate primary or secondary indexterms that do not
|
|
||||||
fit the existing scheme. Some indexterms have been added inside
|
|
||||||
list items or other areas where they are not allowed by our
|
|
||||||
stylesheets, causing <tt>???</tt> to be printed in the index instead of
|
|
||||||
a real page number.</p>
|
|
||||||
|
|
||||||
<p>Index work requires experience and anyone who works on this
|
|
||||||
task is highly encouraged to carefully read through the existing
|
|
||||||
(print-output) index, and to have read the Chicago Manual of
|
|
||||||
Style or other style books that deal with indexing. Please see
|
|
||||||
the SVN history of some of the chapter.xml files to see some of
|
|
||||||
the indexing errors that have been corrected in the past.
|
|
||||||
It is imperative to view the PostScript version of the Handbook
|
|
||||||
after making any changes to indexterms as many errors, such as
|
|
||||||
long words or deeply nested indexterms will break the two column
|
|
||||||
output there, or cause the page number to be listed as <tt>???</tt>.</p>
|
|
||||||
|
|
||||||
<p>There is a script <tt>doc/share/misc/indexreport.pl</tt> which
|
|
||||||
can be used to find areas of an SGML file where
|
|
||||||
<indexterms> are sparse.</p>
|
|
||||||
|
|
||||||
<a name="slides"></a>
|
|
||||||
<h3>Contribute Advocacy Slides/Presentations</h3>
|
|
||||||
|
|
||||||
<p><b>Responsible:</b> FreeBSD-doc
|
|
||||||
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>></p>
|
|
||||||
|
|
||||||
<p><b>Synopsis:</b> Presentations marked up in the DocBook-slides
|
|
||||||
DTD have recently been added to the documentation set in
|
|
||||||
<tt>doc/en_US.ISO8859-1/slides</tt>. More advocacy content is
|
|
||||||
needed, and additional stylesheet work is needed to pull in
|
|
||||||
content from the release notes and other XML content in our
|
|
||||||
documentation set to build up-to-date slides with 'make'. A
|
|
||||||
simple example presentation was committed with some of this
|
|
||||||
functionality, but there is more work to be done! Also, the
|
|
||||||
stylesheets for print/PDF output (using the Java based XSLT
|
|
||||||
processors, PassiveTeX is too limiting for slides) could be
|
|
||||||
improved as the default DocBook Slides XSL-FO stylesheets
|
|
||||||
produce very spartan slides.</p>
|
|
||||||
|
|
||||||
<a name="handbooksection"></a>
|
|
||||||
<h3>Write a section in the Handbook and/or FAQ</h3>
|
|
||||||
|
|
||||||
<p><b>Responsible:</b> FreeBSD-doc
|
|
||||||
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>></p>
|
|
||||||
|
|
||||||
<p><b>Synopsis:</b> Chunks of the FAQ and Handbook have empty sections in
|
|
||||||
them. They need filling. If you have just had to use one of
|
|
||||||
these documents to complete a task, and found them lacking,
|
|
||||||
please find the time to write up your experiences as a
|
|
||||||
possible replacement.</p>
|
|
||||||
|
|
||||||
<p>Alternatively, if you have just had to do something that had no
|
|
||||||
entry in the FAQ and/or Handbook, please consider writing a
|
|
||||||
new section. Then submit it as outlined above.</p>
|
|
||||||
|
|
||||||
<a name="newpapers"></a>
|
|
||||||
<h3>Write some new Papers</h3>
|
|
||||||
|
|
||||||
<h4><font color="#660000">The New SCSI layer for FreeBSD (CAM)</font></h4>
|
|
||||||
<p><b>Responsible:</b>
|
|
||||||
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>>,
|
|
||||||
<<a href="mailto:scsi@FreeBSD.org">scsi@FreeBSD.org</a>></p>
|
|
||||||
<p><b>Synopsis:</b> See <a href="https://people.FreeBSD.org/~gibbs/">
|
|
||||||
The Design and Implementation of the FreeBSD SCSI Subsystem</a>
|
|
||||||
for a first snapshot.</p>
|
|
||||||
|
|
||||||
<a name="cgiscripts"></a>
|
|
||||||
<h3>CGI Scripts</h3>
|
|
||||||
<p><b>Responsible:</b>
|
|
||||||
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>>,
|
|
||||||
Wolfram Schneider <<a href="mailto:wosch@FreeBSD.org">wosch@FreeBSD.org</a>></p>
|
|
||||||
|
|
||||||
<p><b>Synopsis:</b> Modify the CGI script ports.cgi
|
|
||||||
and the script portindex to use the Perl <a
|
|
||||||
href="https://people.FreeBSD.org/~tom/portpm/">FreeBSD::Ports</a>
|
|
||||||
modules. These modules also need thorough testing.</p>
|
|
||||||
|
|
||||||
<a name="multilingualwebscripts"></a>
|
|
||||||
<h3>Multilingual Web scripts</h3>
|
|
||||||
|
|
||||||
<p><b>Responsible:</b>
|
|
||||||
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>></p>
|
|
||||||
<p></p>
|
|
||||||
|
|
||||||
<p><b>Synopsis:</b></p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
Our main Web pages are written in (American) English. The <a
|
|
||||||
href="translations.html">FreeBSD Translations Projects</a>
|
|
||||||
translate the web pages, Handbook and FAQ to other languages.</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
We must translate the cgi scripts and web build scripts too. The
|
|
||||||
scripts should support multiple languages, not only one.
|
|
||||||
Most scripts are written in perl.</p>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
<li>Merge the perl scripts <a
|
|
||||||
href="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/www/en/ports/portindex">www/en/ports/portindex</a>
|
|
||||||
and <a
|
|
||||||
href="ftp://ftp.FreeBSD.org/pub/FreeBSD/FreeBSD-current/www/ja/ports/portindex">www/ja/ports/portindex</a>
|
|
||||||
into one script. Add an option for English and Japanese output.
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
|
|
||||||
<a name="translations"></a>
|
|
||||||
<h3>Translations of the FreeBSD Documentation</h3>
|
|
||||||
<p><b>Responsible:</b>
|
|
||||||
<<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>></p>
|
|
||||||
<p>
|
|
||||||
Translate the FreeBSD documentation (Web pages, FAQ,
|
|
||||||
Handbook, Manual pages) into other languages. See the
|
|
||||||
<a href="translations.html">FreeBSD translations projects</a></p>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
Loading…
Reference in a new issue