Have a table with differences betwen Writers' features

[Progi1984]

No description provided.

[Progi1984]

A starting documentation is present here : http:https://phpword.readthedocs.org/en/develop/index.html

[Progi1984]

@ivanlanin Could you add your table in docs ?

[ivanlanin]

Wow. RTD changes our manual almost instantly :)

Btw, I use pandoc since I'm too lazy to write rst myself.

[ivanlanin]

@Progi1984 Checkout the updated README.md and rst files :)

[Progi1984]

No problem for using Pandoc ;)

For the table with differences, I thought to this : https://github.com/PHPOffice/PHPExcel/blob/master/Documentation/Functionality%20Cross-Reference.xls (without getters & setters)

Furthermore, I think the file Readme.md must not contain the documentation but must be a reference where to find documentation, install, and so on like PHPExcel. Because the documentation is located to two places and we risk to forget updating one.

[ivanlanin]

Ah, I see. Ok. I don't think we could create something like that using markup. It's too complicated. We better use Google Spreadsheet or use Excel, like PHPExcel, and put it in the docs folder. I prefer the first approach since we can keep our source code clean from binaries.

Regarding duplicate docs, I agree. So we keep the README simple and focus on the rst?

[Progi1984]

I have edited the documentation for outputting what I thought : http:https://phpword.readthedocs.org/en/develop/intro.html#file-formats.
It's not Markdown, it's reStructuredText (.rst).

For a simple ReadMe, and a focus on the RST, I agree.

[ivanlanin]

Look much better. Got it. I'll migrate the README.md contents to rst and will continue the documentation there.

Can we close this issue? :)

[Progi1984]

I must redesign the second table and add some features.
I will do this week-end.

[ivanlanin]

While you're on it, could you also check the PDF generated from our docs? There is no TOC, no index page at the back, and the first few pages of PDF looks empty. What should we do? Thanks.

[Progi1984]

I just improved tables with features support.
https://phpword.readthedocs.org/en/develop/intro.html#file-formats

I look at the PDF ;)

[ivanlanin]

Ah, much better now :) But why there's still no TOC? Is there any special setup we have put? RTD seems can't render the checkmarks on the feature table, either.

[Progi1984]

For the TOC, it seems that it's a bug : readthedocs/readthedocs.org#665

[ivanlanin]

The workaround dc28fd6 seems to work :)

[Progi1984]

Yep, Perfect, I close it :)