DX issues

[crusso]

This issue culls the PR from Kento's DX issue survey
https://docs.google.com/document/d/1RP4-So7dNhs5E28lXHJYw-MmteGouU7JuLt4fcIB-io/edit?usp=sharing
and puts the PR links into an issue, so we get helpful summaries.

Meta-issue:

• DX: Developer Experience improvements meta issue #3920

Motoko:

• Collection library wish list #812
• doc: in language manual, inconsistent use of notation #3418
• chore: deprecate and remove Prim.createActor and Internals.create_actor_helper #3420
• mo-doc: extend mo-doc to (optionally) embed links to source code #3422
• Nested actors cause weird error #3434
• doc: add changelog to portal docs #3569
• Mo-doc unable to trace destructured type record argument #3371
• Docusaurus doc preview issues #3366
• Document debug blocks, and how to use them. #3354
• Warn about redundant import URLs #3331
• FR: Improve functional programming for Motoko #3321
• Enhancement: dynamic compatibility check in postupgrade #3199
• Refined Principals #3176
• Timo's Motoko wishlist #3175
• Doc: https://smartcontracts.org/docs/language-guide/actor-classes.html doesn't mention cycle provisioning of created actors on the IC #3154
• Doc: update defn of static pats #3133
• Support selective field import for types. #3145
• As a Motoko developer, I want to be able to annotate my Candid declarations using comments #3120
• Provide syntax for functional record update operations #3072
• Implement bitops for Nat and Int #2799
• [Perf] Ir type checking appears to be a bottleneck #2769
• Importing did files #2756
• Bad (or inconsistent) error message when compiled file is a directory #2700
• Exposing functions with Passthrough Utility Classes #2698
• Doc still mentions Words  #2683
• Statically prevent throw/return from oneway methods #2600
• Roadmap ideas #2556
• Test upgrading from old stable memories #2541
• Local/CI documentation lacks navigation bar #2490
• Design lexical structure for documentation comments #2371
• Improve error messages for module projection #2356
• [mo-doc] Documentation for Prim types #2351
• Meta-issue: Tooling #2308
• Meta-issue: Features #2303
• [mo-doc] Better type formatting #2269
• actor t <: principal #2264
• Better readability for identifying public fields? #2164
• Cycles remaining work  #2140
• Can we afford to trap on bad Candid data? #2106
• Shared generics #2096
• Meta-Issue: Documentation Burn-down list (DRAFT) #2079
• Document debug_show in reference manual? #1977
• Add support for foreign class import (not just motoko class import) #1905
• Short-cut structural equality based on pointer equality #1838
• [mo-doc] Documentation isn't generated for nested modules #1727
• Add tutorial documentation for literal actor references #1676
• Debug.show instead of debug_show #1655
• Add identifier escaping #1668
• Warn about unused identifiers #1489
• Poor error message: "type error, too many type arguments" #1218
• Support multi-canister tests #1202
• Add support for new system API is_controller #3907
• Distinguish query and update calls in await #3898
• Why the shared requirement on async* #3892
• bug: duplicate deprecation warnings #3855
• perf: optimize object layout to save one word #3851
• Unicode character error 'syntax error [M0002], malformed operator' #3803
• language-manual: Binary logical operators missing #3757
• bug: motoko produces a bad error message when an actor class file has a leading type definition. #3739
• FR: treating actor self references as initially defined #3718
• FR: improve import error message  #3711
• doc: missing documentation #3689
• FR: add support for try finally or similar, to allow resource disposal on all exits, even after await. #3688
• bug: mo-doc is failing to emit doc comments for classes #3684
• Typo in description of async #3638
• bug: mo-doc truncates entries in the generated index.md #3626
• RFC: share blob, text and Nat/Int values in stable format #3620

VS Code extension:

• performance improvements vscode-motoko#173
• Do you support showing an outline? vscode-motoko#168
• import handling vscode-motoko#123

Formatter:

• Object auto-formatted into one very long line prettier-plugin-motoko#89
• Format numbers for better readability prettier-plugin-motoko#60
• Convert Doxygen-style comments to documentation comment prettier-plugin-motoko#59
• There should be a space between comment marker and comment prettier-plugin-motoko#58

Vessel:

• Multiple packages in one repo. vessel#37
• Let users specify different targets vessel#26
• Support private library imports vessel#62
• Feature Requests vessel#71

[rvanasa]

Issues related to improving error messages:

• Nested actors cause weird error #3434
• Bad (or inconsistent) error message when compiled file is a directory #2700
• Warn about unused identifiers #1489
• Poor error message: "type error, too many type arguments" #1218
• Unicode character error 'syntax error [M0002], malformed operator' #3803
• bug: motoko produces a bad error message when an actor class file has a leading type definition. #3739
• FR: improve import error message  #3711