Numerics package documentation about quantum-docs-pr HOT 4 CLOSED

That's a good point, @frtibble, thanks for raising the issue. At the moment, we don't have a great way to document which package contributes a given operation or function; especially for those namespaces like Microsoft.Quantum.Arithmetic, Microsoft.Quantum.Math, and Microsoft.Quantum.Convert that are split across packages, it would be good if we could document that similarly to how C# API docs list which assembly contributes a given type. I like the idea of providing better links from namespace descriptions in the meantime, though, as a workaround.

+@bromeg, @natke, and @v-stgr for discussion.

from quantum-docs-pr.

Yes, I agree - your first suggestion would be the clearest, I think, and it'd make the most sense given that's how it's documented in C#. Thanks for considering my suggestion too.

from quantum-docs-pr.

It sounds like we need to document the dependencies between packages?

Is there a one to one correspondence between package and namespace, or not?

from quantum-docs-pr.

There's not generally a one-to-one mapping between namespaces and packages, unfortunately. They are pretty correlated, but there's also namespaces like Microsoft.Quantum.Math and Microsoft.Quantum.Diagnostics that get split across packages for various technical reasons. For the most part, if a user uses the new SDK package, then they should be OK to use everything in the references except for domain-specific functionality brought in from Microsoft.Quantum.Chemistry.*, Microsoft.Quantum.Numerics, Microsoft.Quantum.Research, and Microsoft.Quantum.MachineLearning.

from quantum-docs-pr.