DOC: update doc geometry_area_perimeter

[myl-dvl]

• Closes geometry_area_perimeter limitations not documented #1400]

[snowman2]

Thanks @myl-dvl 👍. If you have a moment to share a screenshot of the docstrings rendered that would be helpful. Otherwise, I will try to build the docs later before merging.

[myl-dvl]

Thanks @myl-dvl 👍. If you have a moment to share a screenshot of the docstrings rendered that would be helpful. Otherwise, I will try to build the docs later before merging.

hum ok, I'm not sure if I need to build the all doc for that or if there is a way to get only the rendering of this snippet.
You want the screenshot in the PR or somewhere else ?

[snowman2]

You want the screenshot in the PR or somewhere else ?

Here in the PR would be great.

[myl-dvl]

Hi, I'm currently stuck trying to build the documentation.
When I try make install-docs It does not recognize "install-docs" as a correct build option.
In fact, no option from CONTRIBUTING.md is listed in my sphinx :

Sphinx v8.2.3
Please use `make target' where target is one of
  html        to make standalone HTML files
  dirhtml     to make HTML files named index.html in directories
  singlehtml  to make a single large HTML file
  pickle      to make pickle files
  json        to make JSON files
  htmlhelp    to make HTML files and an HTML help project
  qthelp      to make HTML files and a qthelp project
  devhelp     to make HTML files and a Devhelp project
  epub        to make an epub
  latex       to make LaTeX files, you can set PAPER=a4 or PAPER=letter
  text        to make text files
  man         to make manual pages
  texinfo     to make Texinfo files
  gettext     to make PO message catalogs
  changes     to make an overview of all changed/added/deprecated items
  xml         to make Docutils-native XML files
  pseudoxml   to make pseudoxml-XML files for display purposes
  linkcheck   to check all external links for integrity
  doctest     to run all doctests embedded in the documentation (if enabled)
  coverage    to run coverage check of the documentation (if enabled)
  clean       to remove everything in the build directory

I'm on Windows, maybe it is linked.
I did a python -m pip install -r requirements-docs.txt previously that was not in the documentation but felt like required (because no make command in Windows).

Any idea on what's wrong ?

Ps: Do I need to open an issue ?

[snowman2]

It is designed for Linux users.

The html command from what you have listed should do it I believe.

[myl-dvl]

Here is the screenshot. Should we update the doc for windows users ? Maybe just add a note.
Thank you for your help on this one.

[snowman2]

Should we update the doc for windows users ?

That would be helpful.

[snowman2]

Thanks @myl-dvl 👍