docs: capture our policy for the options shared and fPIC

[prince-chrismc]

Docs!

This came as a question on Slack, thought it was worth writing down

https://cpplang.slack.com/archives/C41CWV9HA/p1660683315599809

[jgsogo]

IMHO, there is some overlapping between this section and https://github.com/conan-io/conan-center-index/blob/master/docs/packaging_policy.md#options, we can argue that one is targeting reviewers while the other is more for recipe authors... but in the end both are the same people and both sections should contain the same message. Maybe it is time to merge those sections and update them, wdyt?

[uilianries]

Yes. Indeed is a sad situation when you are a newbie knows nothing about it and need a review to discover default values and other stuff. Merging sections sounds good.

[prince-chrismc]

Maybe it is time to merge those sections and update them, wdyt?

Given I was not able to find these docs... I think it's worth giving it some TLC and combining things together with "how to add package" might be the next step

[prince-chrismc]

I've decided to revive this since conference are making my other idea take longer then expected

[uilianries]

LGTM

[jgsogo]

IMHO, the note about the default value of shared option for other packages is really important.

[franramirez688]

FYI, Conan 1.53 will bring the new method rm_safe (also for settings) so it'll be possible to avoid those try-except structures. It'll look like this:

   def configure(self):
      if self.options.shared:
         self.options.rm_safe("fPIC")

[prince-chrismc]

Thanks for holding my hand 💟 I think I finally captured the important parts

[uilianries]

It would be nice adding a note about how it affects self.info.settings and self.info.options. Settings is None and settings.compiler is not make affect for check_min_cppstd, only when installing the package. Otherwise, it would require validate_build with self.settings.compiler

[prince-chrismc]

I think that should go into the main Conan docs since it's pretty generic.
"For more information about how this affects the package_id read the documentation here" type of thing?

[conan-center-bot]

Updating docs!