Update docs: choosing a principal

[ghost]

Principal can be specified by the package path (i.e. including module name). I have not found a description of this feature anywhere.

[fredbi]

Thank you. That's indeed a feature.

[ghost]

Thank you. That's indeed a feature.

Yeah, I was surprised when I found this.

Some time ago, I tried to specify the full path to file with principal, which didn't work. I think this should be added to the documentation.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (1e29a3d) 82.64% compared to head (49fa925) 82.65%.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #3058   +/-   ##
=======================================
  Coverage   82.64%   82.65%           
=======================================
  Files          62       62           
  Lines       12856    12856           
=======================================
+ Hits        10625    10626    +1     
+ Misses       1692     1691    -1     
  Partials      539      539           

Flag	Coverage Δ
codegen-oldstable-canary-fixtures	32.55% <ø> (ø)
codegen-stable-canary-fixtures	32.55% <ø> (ø)
unit-oldstable	82.79% <ø> (ø)
unit-stable	82.80% <ø> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[ghost]

@fredbi what about update docs on goswagger.io? There are still no changes

[fredbi]

Yes you’re correct
We have a clumsy process to update the site.
I’ve been working on a branch to fully automate that part from CI, but couldn’t complet it so far. Thanks for reminding me this overdue task… :)