FamilySearchPlaceState docs are invalid

Question

FamilySearchPlaceState docs are invalid

Closed this issue 9 years ago · 5 comments

See http://familysearch.github.io/gedcomx-php/docs/class-Gedcomx.Extensions.FamilySearch.Rs.Client.FamilySearchPlaceState.html

Answer 1 · 2015-07-13T20:58:28.000Z

That might be due to outdated docs

Answer 2 · 2015-07-13T20:59:23.000Z

@jimmyz How do you update the docs?

Answer 3 · 2015-07-16T22:10:55.000Z

The docs are generated via ApiGen.

I used a modified version of the ThemeBootstrap project in order to get the search drop-down and a few other things to be wide enough for the long namespacing of the gedcomx-php classes. I'll push the changes to a forked version of the theme.

The command to generate it with the custom theme is found here:
https://gist.github.com/jimmyz/f1a6cf18dc114850a881

Answer 4 · 2015-07-16T22:23:50.000Z

Okay, here's my fork of the ThemeBootstrap project:
https://github.com/jimmyz/ThemeBootstrap

Answer 5 · 2015-07-17T22:11:26.000Z

I ran the process to generate a new version of the docs, which is now deployed, but generating the doc gave the following Parse error:

Parse error: Class Gedcomx\Extensions\FamilySearch\Rs\Client\FamilySearchPlaceState was redeclared (previously declared in file /workspace/sdks/php/gedcomx-php/src/Extensions/FamilySearch/FamilySearchPlaceState.php).

This could be the reason for the inaccurate docs. Perhaps the FamilySearchPlaceState is found in multiple files.