Skip to content

Update images and links#86

Open
jvenczel-arch wants to merge 24 commits into
DynamoDS:masterfrom
jvenczel-arch:Update-images-and-links
Open

Update images and links#86
jvenczel-arch wants to merge 24 commits into
DynamoDS:masterfrom
jvenczel-arch:Update-images-and-links

Conversation

@jvenczel-arch

@jvenczel-arch jvenczel-arch commented Jun 2, 2026

Copy link
Copy Markdown

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:

Page | New filename -- | -- Dynamo 2.x | 1-updating-your-packages-and-dynamo-libraries-for-dynamo-2x.md Dynamo 3.x / .NET 8 | 2-updating-your-packages-and-dynamo-libraries-for-dynamo-3x-Net8.md Dynamo 4.x / .NET 10 | 3-updating-your-packages-and-dynamo-libraries-for-dynamo-4x.md Migrating node icons to .NET 10 | 4-migrating-node-icons.md

Content moved / added

  • Moved: Dynamo 2.x / 3.x / 4.x package migration guides from 3_developing_for_dynamo/  8_updating_packages/
  • Added: 4-migrating-node-icons.md (node icon migration for .NET 10)
  • Added: 9_migrating_versions/ section with Python/.NET runtime migration documentation

Follow-up items (incomplete renames / stale links)

A few items may still need attention before merge:

  1. 13-dynamo-integration.md — file on disk is not yet renamed to 12-dynamo-integration.md, but SUMMARY.md and internal links already reference 12-.
  2. a_appendix/dotnet-compatibility.md — links still point to 3_developing_for_dynamo/ instead of 8_updating_packages/.
  3. 13-dynamo-integration.md — migration guide links use bare filenames (1-updating-...) and may need paths updated to ../8_updating_packages/.
  4. 3-updating-your-packages-and-dynamo-libraries-for-dynamo-4x copy.md — duplicate/copy file exists; the canonical 3-updating-...-dynamo-4x.md file may be missing.

Test plan

  •  Build/preview the GitBook site and confirm all Developer Primer TOC entries resolve
  •  Verify Updating Packages section links (2.x, 3.x, 4.x, node icons)
  •  Verify Migrating to Python 3 section links
  •  Confirm .NET Compatibility appendix links reach the correct migration guides
  •  Confirm Dynamo Integration page internal navigation works after rename to 12-dynamo-integration.md

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
@jvenczel-arch jvenczel-arch marked this pull request as ready for review June 11, 2026 12:09
References to Lunchbox removed from panelisation and images updated

file naming changes

Create 06 codeblock - list create.jpg
@jvenczel-arch jvenczel-arch force-pushed the Update-images-and-links branch from 21b30eb to 791890f Compare June 12, 2026 13:16
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

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.md to 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 under 11_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.

Comment thread a_appendix/dotnet-compatibility.md Outdated
Comment thread SUMMARY.md
Comment thread SUMMARY.md Outdated
Comment thread 9_best_practices/5-efficiently-working-with-large-datasets.md Outdated
Comment thread 9_best_practices/5-efficiently-working-with-large-datasets.md Outdated
Comment thread .vs/VSWorkspaceState.json
Comment thread 11_developer_primer/9_migrating_versions/0-introduction.md Outdated
Comment thread 11_developer_primer/9_migrating_versions/4-obstacles-and-workaround.md Outdated
Comment thread 11_developer_primer/9_migrating_versions/4-obstacles-and-workaround.md Outdated
Comment thread 11_developer_primer/9_migrating_versions/4-obstacles-and-workaround.md Outdated
@jasonstratton

Copy link
Copy Markdown
Contributor
  • 11_developer_primer9_migrating_versions/0-introduction.md
  • 1-migrating-to-net-core.md
  • 2-migrating-to-pythonnet3.md
  • 4-obstacles-and-workaround.md
  • 8_updating_packages/4-migrating-node-icons.md
  • 2_build_dynamo_from_source/3-managing-and-updating-dependancies-in-dynamo-nugets.md

All six new files landed with CRLF. Per repo convention, new files must use LF.

@jasonstratton jasonstratton left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread SUMMARY.md
Comment thread a_appendix/dotnet-compatibility.md Outdated
Comment thread 11_developer_primer/3_developing_for_dynamo/1-getting-started.md
Comment thread SUMMARY.md Outdated
Comment thread 5_essential_nodes_and_concepts/index-of-nodes.md Outdated
Updates to customization activity in dynamo for revit section
Comment thread 11_developer_primer/3_developing_for_dynamo/13-dynamo-integration.md Outdated
Comment thread 11_developer_primer/3_developing_for_dynamo/13-dynamo-integration.md Outdated
Comment thread 11_developer_primer/3_developing_for_dynamo/13-dynamo-integration.md Outdated
Comment thread 11_developer_primer/3_developing_for_dynamo/13-dynamo-integration.md Outdated
Comment thread 11_developer_primer/3_developing_for_dynamo/13-dynamo-integration.md Outdated
Comment thread 1_introduction/2-primer-user-guide-dynamo-community-and-platform.md Outdated
Comment thread 3_user_interface/2-library.md Outdated
Comment thread 5_essential_nodes_and_concepts/5-2_geometry-for-computational-design/2-vectors.md Outdated
```

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.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

S/b "Scaling and shearing"?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants