Bug 48242

Summary: POI Website Improvements
Product: POI Reporter: David Fisher <dfisher>
Component: POI OverallAssignee: POI Developers List <dev>
Status: RESOLVED FIXED    
Severity: enhancement    
Priority: P2    
Version: 3.6-dev   
Target Milestone: ---   
Hardware: All   
OS: All   

Description David Fisher 2009-11-19 13:20:19 UTC
I about to commit the following many improvements to subversion on trunk.

Regards,
Dave

(All paths here are relative to src/documentation)

(1) Main Page - content/xdocs/index.xml

Improved discussion. Moved some content to the component overview. Adjusted the mission statement for OOXML. Tried to make it more narrative with links to everything.

(2) Component Overview - content/xdocs/overview.xml

Improved discussion and better table of components, jars, and maven artifacts.

(3) Download Page - content/xdocs/download.xml

Adjusted the language, reorganized the page and provided an example of verification.

(4) How to Build - content/xdocs/howtobuild.xml

Improved the discussion and broke up the ant from the forrest documentation

(5) Guidelines - content/xdocs/guidelines.xml

This was cloned from getinvolved/index.xml.

(6) Outline - content/xdocs/book.xml

Adjusted the site outline to:
Overview - Home, Download, Components, Text Extraction, Case Studies, and Legal
Help - Javadocs, FAQ, Mailing Lists, Bug Database, and Changes Log
Getting Involved - Subversion Repository, How To Build, Contribution Guidelines, and Who We Are
Component APIs - Excel (SS=HSSF+XSSF), Word (HWPF+XWPF), PowerPoint (HSLF+XSLF), OpenXML4J (OOXML), OLE2 Filesystem (POIFS), OLE2 Document Props (HPSF), Outlook (HSMF), Visio (HDGF), and Publisher (HPBF)

(7) Who We Are - content/xdocs/who.xml

Moved emeritus to the bottom, removed dead links, some adjustment to wording. Dead links and old emails removed or changed.

(8) Legal - content/xdocs/legal.xml

Added link to Apache License and mention where the NOTICE is found. Mention more of Microsoft's file formats that are now in the project.

(9) Minor text and title improvements - 
content/xdocs/text-extraction.xml
content/xdocs/subversion.xml
content/xdocs/faq.xml

(10) Case Studies - content/xdocs/casestudies.xml

Added Lafferty case.

(11) Website formatting and other small corrections.

(a) remove extra footer from the bottom of pdfs
skins/poi-site/xslt/fo/document2fo.xsl

(b) move poi logo all the way to the right.
skins/poi-site/xslt/html/site2xhtml.xsl

(c) adjust the search poi at the bottom of the left navigation
skins/poi-site/xslt/html/site2xhtml.xsl

(d) fix broken anchors on the fax
skins/poi-site/xslt/html/document2html.xsl

You can now use <section id="anchor"> to set an anchor.

(e) don't obfuscate email links on mailing list page. we already avoid showing author emails - by not including a link on the bylines and also by not generating xml. show the forrest logo.
skinconf.xml

(f) source formatting in pdfs
content/xdocs/text-extraction.xml
Comment 1 David Fisher 2009-11-19 13:25:51 UTC
You can see the changes here http://svn.apache.org/viewvc?view=revision&revision=882301

I will push a build of the documentation onto poi.apache.org after we tkae time to discuss.
Comment 2 David Fisher 2009-11-20 10:56:26 UTC
Improvements are copied to the proper location for http://poi.apache.org/

Project doap file is updated.