I would like to help out

[Tom Popovich <to...@gmail.com>]

I was thinking of starting some open source projects (from older ideas that
I had) and also
helping existing projects,

I saw this: And would be interested in learning how to join apache and help
out.

thanks, Tom Popovich


*Task added: *Sun May 29 2016
*Difficulty: * Journeyman - This requires a bit of knowledge of the
project, but otherwise is an easy task
*Task type:* Documentation and Guides

We introduced classes which provide support for the Microsoft Visio file
format (.vsdx ). Internally this is called XDGF.

Unfortunately the documentation about XDGF is lacking a bit,
http://poi.apache.org/overview.html does not list it correctly and the
sidebar point to http://poi.apache.org/hdgf/index.html, which is the
pre-Office 2007 .vsd-format, not .vsdx.

The documentation is built as Apache Forrest XML files. The source for
these is located at https://svn.apache.org/repos/asf/poi/site/

The task includes reviewing the overview description of formats supported
by Apache POI to properly list the support for Visio file formats and to
add new documentation for the XDGF file format if necessary/appropriate.

Re: I would like to help out

[Dominik Stadler <do...@gmx.at>]

Hi,

great to get some help!

Dustin, the author of some of the Visio functionality, recently updated a
few things already, but there is surely a big need for more description and
guides for users to make it easier to get started.

All the documentation pages live in Subversion at
https://svn.apache.org/repos/asf/poi/site/, the latest Apache POI code is
at https://svn.apache.org/repos/asf/poi/site/, it pulls in the docs via an
SVN external link. When changes are checked in, they are immediately
published to http://poi.apache.org/ <http://poi.apache.org/howtobuild.html>

You probably can start by trying to get the docs built as described at
http://poi.apache.org/howtobuild.html by installing Apache Forrest in the
specified version. With this you can build the documentation pages locally
and take a look before submitting them.

You likely need to take a look at the available classes/code a bit and what
functionality they provide. One thing that usually helps developers most is
a "Quick Guide" which provides ready-made samples of how to do things with
the library, see e.g. http://poi.apache.org/spreadsheet/quick-guide.html
for something like this for the Excel format support.

I suggest you take a look around a bit and then get back to us with any
questions/hurdles that you ran into so we can get you going quickly!

Dominik.

On Thu, Jun 30, 2016 at 2:09 AM, Tom Popovich <to...@gmail.com>
wrote:

> I was thinking of starting some open source projects (from older ideas that
> I had) and also
> helping existing projects,
>
> I saw this: And would be interested in learning how to join apache and help
> out.
>
> thanks, Tom Popovich
>
>
> *Task added: *Sun May 29 2016
> *Difficulty: * Journeyman - This requires a bit of knowledge of the
> project, but otherwise is an easy task
> *Task type:* Documentation and Guides
>
> We introduced classes which provide support for the Microsoft Visio file
> format (.vsdx ). Internally this is called XDGF.
>
> Unfortunately the documentation about XDGF is lacking a bit,
> http://poi.apache.org/overview.html does not list it correctly and the
> sidebar point to http://poi.apache.org/hdgf/index.html, which is the
> pre-Office 2007 .vsd-format, not .vsdx.
>
> The documentation is built as Apache Forrest XML files. The source for
> these is located at https://svn.apache.org/repos/asf/poi/site/
>
> The task includes reviewing the overview description of formats supported
> by Apache POI to properly list the support for Visio file formats and to
> add new documentation for the XDGF file format if necessary/appropriate.
>