Update images and links#86
Conversation
Grammar and spelling fixes
Syntax, spelling and grammar updates up to chapter 7
Updates to chapters 8 and 9 for syntax, spelling and grammar
Grammar and syntax fixes for developer primer
syntax updates
Grammar and syntax updates for all developer primer
Last of the files checked for syntax and grammar
New images and icons added to match current dynamo appearance
reversion of using numbering in conjunction with pictures
Links throughout the primer checked and updated
Section for python 3 migration and package updates added. Also codeblocks given specified code to improve code snippet examples.
Fixes made to some images and general edits
page added for dealing with custom node icons
new files added and nuget compatibility
Several images edited and mismatch in code example fixed
References to Lunchbox removed from panelisation and images updated file naming changes Create 06 codeblock - list create.jpg
21b30eb to
791890f
Compare
file path changed for links so everything is consistent to new gitbook location
dotnet versions targeted by nuget packages 3.3.2 added
customize panel section changed to include panelSurface nodes instead of clockwork panels
There was a problem hiding this comment.
Pull request overview
This PR reorganizes and refreshes the documentation site navigation and content, primarily by restructuring the Developer Primer table of contents, moving package-migration guidance into a dedicated section, and updating links/images/wording across the docs to match the new layout.
Changes:
- Reworked
SUMMARY.mdto renumber/reorder Developer Primer topics and add new “Updating Packages” + “Migrating…” sections. - Added new migration documentation under
11_developer_primer/9_migrating_versions/and new package-updating guides under11_developer_primer/8_updating_packages/. - Performed broad doc cleanups (link updates, grammar fixes, image reference updates), plus added a new GitBook asset.
Reviewed changes
Copilot reviewed 101 out of 187 changed files in this pull request and generated 20 comments.
Show a summary per file
| File | Description |
|---|---|
| SUMMARY.md | Reorganized TOC; added new sections/renumbered pages |
| README.md | Updated Dynamo download link text/URL |
| dynamo-for-civil-3d/sample-workflows/utilities/rename-structures.md | Wording fixes and emphasis tweaks |
| dynamo-for-civil-3d/sample-workflows/surveying/point-group-management.md | Minor punctuation/style fix |
| dynamo-for-civil-3d/sample-workflows/roads/light-pole-placement.md | Wording cleanup |
| dynamo-for-civil-3d/sample-workflows/land/service-placement.md | Grammar fixes |
| dynamo-for-civil-3d/node-library.md | Taxonomy wording update |
| dynamo-for-civil-3d/advanced-topics/python-and-civil-3d.md | Typo fix in footnote text |
| dynamo-compute-service/engine-lifecycle.md | Typo/punctuation fix |
| a_appendix/dotnet-compatibility.md | Updated migration-guide links (currently incorrect paths) |
| a_appendix/a-7_frequently-asked-questions.md | Table formatting fix |
| a_appendix/a-3_packages.md | Updated Rhynamo link |
| a_appendix/a-2_resources.md | Updated blog URL; removed “Building Coder” block |
| a_appendix/a-1_visual-programming-and-dynamo.md | Wording improvements; code fence language tag |
| 9_best_practices/5-efficiently-working-with-large-datasets.md | Text cleanup; link path changes (now using backslashes) |
| 9_best_practices/4-managing-your-program.md | Punctuation fix |
| 9_best_practices/3-scripting-reference.md | Grammar/spacing fixes |
| 9_best_practices/2-scripting-strategies.md | Wording/formatting cleanup in prose + snippets |
| 9_best_practices/1-graph-strategies.md | Markdown emphasis/wording cleanups |
| 8_coding_in_dynamo/8-4_language-changes/1-dynamo-2.0-language-changes.md | Punctuation/wording updates; heading numbering edit |
| 8_coding_in_dynamo/8-3_python/3-python-templates.md | Comment formatting cleanup |
| 8_coding_in_dynamo/8-3_python/2-python-revit.md | Comment/formatting cleanup; additional blank lines in code |
| 8_coding_in_dynamo/8-3_python/1-python.md | Link/path and wording updates (now contains backslashes) |
| 8_coding_in_dynamo/8-2_geometry-with-design-script/7-geometric-parameterization.md | Grammar/formatting cleanup; line wrapping |
| 8_coding_in_dynamo/8-2_geometry-with-design-script/6-surfaces.md | Code formatting cleanup |
| 8_coding_in_dynamo/8-2_geometry-with-design-script/5-translation-rotation-and-other-transformations.md | Terminology edits (introduced “Shared” vs “Sheared” typos) |
| 8_coding_in_dynamo/8-2_geometry-with-design-script/3-vector-math.md | Punctuation spacing fix |
| 8_coding_in_dynamo/8-2_geometry-with-design-script/2-geometric-primitives.md | Code formatting cleanup |
| 8_coding_in_dynamo/8-1_code-blocks-and-design-script/4-functions.md | Code fence language tags; formatting tweaks |
| 8_coding_in_dynamo/8-1_code-blocks-and-design-script/3-shorthand.md | Fixed broken image reference; wording tweaks |
| 8_coding_in_dynamo/8-1_code-blocks-and-design-script/2-design-script-syntax.md | Wording cleanup |
| 7_dynamo_for_revit/6-documenting.md | Wording/formatting cleanup |
| 7_dynamo_for_revit/5-customizing.md | Updated workflow steps; added Python snippet for panel points |
| 7_dynamo_for_revit/4-creating.md | Wording cleanup; link path changed (now uses backslashes) |
| 7_dynamo_for_revit/3-editing.md | Link anchor fix and wording/punctuation tweaks |
| 7_dynamo_for_revit/2-selecting.md | Wording cleanup; link path changed (now uses backslashes) |
| 7_dynamo_for_revit/1-the-revit-connection.md | Table punctuation fix |
| 6_custom_nodes_and_packages/6-2_packages/5-zero-touch.md | Updated external URLs; wording tweaks |
| 6_custom_nodes_and_packages/6-2_packages/4-publishing.md | UI label wording updates; typo fixes |
| 6_custom_nodes_and_packages/6-2_packages/3-developing.md | Heading capitalization fix |
| 6_custom_nodes_and_packages/6-2_packages/2-mesh-toolkit.md | Grammar tweak |
| 6_custom_nodes_and_packages/6-2_packages/1-introduction.md | Minor wording change |
| 6_custom_nodes_and_packages/6-1_custom-nodes/README.md | Punctuation tweak |
| 6_custom_nodes_and_packages/6-1_custom-nodes/3-library.md | Wording tweak |
| 5_essential_nodes_and_concepts/5-5_dictionaries-in-dynamo/1-what-is-a-dictionary.md | Punctuation tweak |
| 5_essential_nodes_and_concepts/5-4_designing-with-lists/4-n-dimensional-lists.md | Grammar fixes |
| 5_essential_nodes_and_concepts/5-4_designing-with-lists/3-lists-of-lists.md | Formatting and wording cleanup |
| 5_essential_nodes_and_concepts/5-4_designing-with-lists/2-working-with-lists.md | Punctuation consistency |
| 5_essential_nodes_and_concepts/5-4_designing-with-lists/1-whats-a-list.md | Wording tweak |
| 5_essential_nodes_and_concepts/5-3_the-building-blocks-of-programs/5-color.md | Instruction formatting tweaks |
| 5_essential_nodes_and_concepts/5-3_the-building-blocks-of-programs/4-strings.md | Grammar fix |
| 5_essential_nodes_and_concepts/5-3_the-building-blocks-of-programs/3-logic.md | Instruction formatting tweaks |
| 5_essential_nodes_and_concepts/5-3_the-building-blocks-of-programs/2-math.md | Wording and external link change |
| 5_essential_nodes_and_concepts/5-3_the-building-blocks-of-programs/1-data.md | Capitalization tweaks |
| 5_essential_nodes_and_concepts/5-2_geometry-for-computational-design/README.md | Punctuation tweak |
| 5_essential_nodes_and_concepts/5-2_geometry-for-computational-design/6-solids.md | Punctuation consistency |
| 5_essential_nodes_and_concepts/5-2_geometry-for-computational-design/3-points.md | Wording tweak |
| 5_essential_nodes_and_concepts/5-2_geometry-for-computational-design/2-vectors.md | Punctuation tweak |
| 5_essential_nodes_and_concepts/5-2_geometry-for-computational-design/1-geometry-overview.md | Grammar fix (i.e.) |
| 4_nodes_and_wires/README.md | Instruction wording tweaks |
| 3_user_interface/README.md | Grammar tweaks |
| 3_user_interface/2-library.md | Wording tweaks |
| 3_user_interface/1-workspace.md | Punctuation tweak |
| 2_setup_for_dynamo/README.md | Download section edit (introduced sentence fragment) |
| 11_developer_primer/9_migrating_versions/4-obstacles-and-workaround.md | New migration notes; contains typos + a broken code snippet |
| 11_developer_primer/9_migrating_versions/3-migrating-from-cpython-to-pythonnet3.md | New migration guide content |
| 11_developer_primer/9_migrating_versions/1-migrating-to-net-core.md | New migration guide content |
| 11_developer_primer/9_migrating_versions/0-introduction.md | New section intro; contains a table typo (“CPthyon3”) |
| 11_developer_primer/8_updating_packages/3-updating-your-packages-and-dynamo-libraries-for-dynamo-4x.md | Updated/expanded Dynamo 4.x guidance; minor typo (“prefered”) |
| 11_developer_primer/8_updating_packages/2-updating-your-packages-and-dynamo-libraries-for-dynamo-3x-Net8.md | New Dynamo 3.x/.NET 8 package guidance |
| 11_developer_primer/8_updating_packages/1-updating-your-packages-and-dynamo-libraries-for-dynamo-2x.md | Updated 2.x guidance; contains backslash link |
| 11_developer_primer/7_examples/README.md | Link target update |
| 11_developer_primer/6_testing_expectations/1-testing-expectations.md | Wording/punctuation cleanup |
| 11_developer_primer/5_pull_requests/1-pull-requests.md | Punctuation consistency |
| 11_developer_primer/4_publish_a_package/README.md | Wording tweak |
| 11_developer_primer/4_publish_a_package/2-extensions-as-packages.md | Code fence language tag + wording tweaks |
| 11_developer_primer/4_publish_a_package/1-build-a-package-from-visual-studio.md | Wording + code fence tag |
| 11_developer_primer/3_developing_for_dynamo/README.md | Wording tweak |
| 11_developer_primer/3_developing_for_dynamo/9-command-line-interface.md | Capitalization/wording cleanup |
| 11_developer_primer/3_developing_for_dynamo/8-defining-custom-package-organisation-dynamo2.0+.md | Snippet brace fix |
| 11_developer_primer/3_developing_for_dynamo/7-advanced-dynamo-node-customisation.md | Formatting + code fence tags + wording tweaks |
| 11_developer_primer/3_developing_for_dynamo/6-extensions.md | Code fence tags + formatting |
| 11_developer_primer/3_developing_for_dynamo/5-nodemodel-case-study-custom-ui.md | Formatting/code fence tags |
| 11_developer_primer/3_developing_for_dynamo/3-executing-python-scripts-in-zero-touch-nodes-c.md | Code fence language tag |
| 11_developer_primer/3_developing_for_dynamo/2-zero-touch-case-study-grid-node.md | Added missing step in instructions; code fence tag |
| 11_developer_primer/3_developing_for_dynamo/11-developing-for-dynamo-for-revit.md | Formatting/code fence tags |
| 11_developer_primer/3_developing_for_dynamo/10-using-com-(interop)-types-in-dynamo-packages.md | Wording tweaks; code fence tag |
| 11_developer_primer/3_developing_for_dynamo/1-getting-started.md | Example renaming + version text update; code fence tag |
| 11_developer_primer/2_build_dynamo_from_source/README.md | Wording/capitalization updates |
| 11_developer_primer/2_build_dynamo_from_source/3-managing-and-updating-dependancies-in-dynamo-nugets.md | New dependency matrix page; contains naming typos/casing issues |
| 11_developer_primer/2_build_dynamo_from_source/2-managing-and-updating-dependancies-in-dynamo.md | Wording updates |
| 11_developer_primer/2_build_dynamo_from_source/1-build-dynamorevit-from-source.md | Updated links + wording; contains .pbd typo |
| 10_sample_workflow/10-1_getting-started-workflows/2-attractor-points.md | Formatting tweaks |
| 10_sample_workflow/10-1_getting-started-workflows/1-parametric-vase.md | Wording tweaks |
| 1_introduction/2-primer-user-guide-dynamo-community-and-platform.md | Wording tweaks |
| 1_introduction/1-what-is-dynamo.md | Capitalization change |
| .vs/VSWorkspaceState.json | Added VS workspace artifact |
| .vs/DynamoPrimerNew.slnx/v18/DocumentLayout.json | Added VS workspace artifact incl. absolute local path |
| .vs/DynamoPrimerNew.slnx/v18/DocumentLayout.backup.json | Added VS workspace artifact incl. absolute local path |
| .gitbook/assets/index of nodes - modulo.jpg | Added new image asset |
Comments suppressed due to low confidence (2)
11_developer_primer/8_updating_packages/1-updating-your-packages-and-dynamo-libraries-for-dynamo-2x.md:26
- This link target uses backslashes and will likely not resolve correctly in GitBook/Markdown. Use forward slashes (and keep it relative to the current folder).
11_developer_primer/8_updating_packages/3-updating-your-packages-and-dynamo-libraries-for-dynamo-4x.md:46 - Minor typo: "prefered" should be "preferred".
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
All six new files landed with CRLF. Per repo convention, new files must use LF. |
jasonstratton
left a comment
There was a problem hiding this comment.
Mechanical check of broken links and missing files in my comments and will require changes.
There are copilot changes to take a look at.
I'll try to take a review of the content next.
Updates to customization activity in dynamo for revit section
| ``` | ||
|
|
||
| Scaling and shearing are comparatively more complex geometric transformations than rotation and translation, so not every Dynamo object can undergo these transformations. The following table outlines which Dynamo objects can have non-uniformly scaled CoordinateSystems, and sheared CoordinateSystems. | ||
| Scaling and sharing are comparatively more complex geometric transformations than rotation and translation, so not every Dynamo object can undergo these transformations. The following table outlines which Dynamo objects can have non-uniformly scaled Coordinate Systems, and shared Coordinate Systems. |
There was a problem hiding this comment.
S/b "Scaling and shearing"?
There was a problem hiding this comment.
I thought this was a typo but I think it may refer to "shear mapping". Have updated to reflect
Comments from reviewers and Copilot responded to. All line ending changed from CRLF to LF.
Summary
This pull request reorganizes the Developer Primer documentation: renumbers several guides under
3_developing_for_dynamo/, moves package migration content into its own section, and updates cross-links across the primer so navigation matches the new layout.Structural changes (
SUMMARY.md)Developing for Dynamo (
3_developing_for_dynamo/)Package migration guides were removed from this section. It now focuses on core development topics (getting started, zero-touch, extensions, integration, etc.).
New: Updating Packages (
8_updating_packages/)A dedicated section was added for Dynamo version migration guides:
Content moved / added
3_developing_for_dynamo/→8_updating_packages/4-migrating-node-icons.md(node icon migration for .NET 10)9_migrating_versions/section with Python/.NET runtime migration documentationFollow-up items (incomplete renames / stale links)
A few items may still need attention before merge:
13-dynamo-integration.md— file on disk is not yet renamed to12-dynamo-integration.md, butSUMMARY.mdand internal links already reference12-.a_appendix/dotnet-compatibility.md— links still point to3_developing_for_dynamo/instead of8_updating_packages/.13-dynamo-integration.md— migration guide links use bare filenames (1-updating-...) and may need paths updated to../8_updating_packages/.3-updating-your-packages-and-dynamo-libraries-for-dynamo-4x copy.md— duplicate/copy file exists; the canonical3-updating-...-dynamo-4x.mdfile may be missing.Test plan
.NET Compatibilityappendix links reach the correct migration guides12-dynamo-integration.md