Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Re-Add Function Documentation #320

Merged
merged 37 commits into from
Dec 3, 2023
Merged

Conversation

johannes-wolf
Copy link
Member

@johannes-wolf johannes-wolf commented Nov 7, 2023

This PR re-adds source-code documentation comments:

  • grouping.typ
  • shapes.typ
  • transformations.typ
  • styling.typ
  • Internals needed for adding custom elements

Also added some additional information.

Documentation about path internals and how to modify paths to create path effects has not yet been added.

@johannes-wolf
Copy link
Member Author

Rebased.

Base automatically changed from hobby-curve to 0.2.0 November 14, 2023 08:40
@fenjalien fenjalien force-pushed the readd-function-documentation branch 2 times, most recently from 0b0ae70 to 1f6aa2c Compare November 22, 2023 18:55
@fenjalien fenjalien mentioned this pull request Nov 22, 2023
@johannes-wolf johannes-wolf force-pushed the readd-function-documentation branch 5 times, most recently from 5141069 to 0a360e7 Compare November 22, 2023 22:45
@johannes-wolf johannes-wolf mentioned this pull request Dec 1, 2023
manual.pdf Outdated

Choose a reason for hiding this comment

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

Palettes are not showing the entire palette like before. I liked the version on the left side more. Is this intended?
image

Copy link
Member Author

@johannes-wolf johannes-wolf Dec 1, 2023

Choose a reason for hiding this comment

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

The palette fix PR #332 should fix that.

src/canvas.typ Outdated Show resolved Hide resolved
src/coordinate.typ Outdated Show resolved Hide resolved
src/draw/grouping.typ Outdated Show resolved Hide resolved
@@ -174,6 +244,14 @@
},)
}

/// TODO: Not writing the docs for this as it should be removed in place of better anchors before 0.2

Choose a reason for hiding this comment

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

Is this ToDo resolved?

Copy link
Member

Choose a reason for hiding this comment

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

No not yet I should have time this week to reslove it though.

@@ -261,6 +408,16 @@
},)
}

/// TODO: Not writing the docs for this as it should be removed in place of better anchors before 0.2

Choose a reason for hiding this comment

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

Is this also resolved?

Copy link
Member

Choose a reason for hiding this comment

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

Same as above :)

src/lib/plot/line.typ Outdated Show resolved Hide resolved
src/lib/plot/line.typ Outdated Show resolved Hide resolved
src/lib/plot/line.typ Outdated Show resolved Hide resolved
Copy link

@JohnMeyerhoff JohnMeyerhoff left a comment

Choose a reason for hiding this comment

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

Looks good to me except for some wordings / typos :)

src/lib/plot.typ Outdated Show resolved Hide resolved
src/lib/plot.typ Outdated Show resolved Hide resolved
src/lib/plot.typ Outdated Show resolved Hide resolved
src/lib/plot.typ Outdated Show resolved Hide resolved
src/lib/plot.typ Outdated Show resolved Hide resolved
src/lib/plot.typ Outdated Show resolved Hide resolved
src/lib/plot.typ Outdated Show resolved Hide resolved
manual.typ Outdated Show resolved Hide resolved
@johannes-wolf johannes-wolf merged commit 3a1705d into 0.2.0 Dec 3, 2023
2 checks passed
@johannes-wolf johannes-wolf deleted the readd-function-documentation branch December 3, 2023 16:28
Copy link

@JohnMeyerhoff JohnMeyerhoff left a comment

Choose a reason for hiding this comment

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

Found some more typos in matrix.typ, the rest looks good to me 👍

@@ -8,7 +8,13 @@

#let pi = calc.pi

// Create identity matrix with dim `m`, `n`
/// Create identity matrix with dimensions $m times n$

Choose a reason for hiding this comment

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

Wording:
dimensions m times n should be
dimensions m by n

#let dim(m) = {
return (m.len(), if m.len() > 0 {m.at(0).len()} else {0})
}

// Return 4x4 translation matrix
/// Return a $4 times 4$ translation matrix

Choose a reason for hiding this comment

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

See above:
4 by 4 translation matrix

#let transform-translate(x, y, z) = {
((1, 0, 0, x),
(0, 1, 0, y),
(0, 0, 1, z),
(0, 0, 0, 1))
}

// Return 4x4 z-shear matrix
/// Return a $4 times 4$ z-shear matrix

Choose a reason for hiding this comment

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

See above:
4 by 4 translation matrix

@@ -847,7 +847,7 @@ get-ctx(ctx => {

Each CeTZ element (`line`, `bezier`, `circle`, ...) returns an array of
functions for drawing to the canvas. Such function takes the canvas'
context object and must return an dictionary of the following keys:
context and must return an dictionary of the following keys:

Choose a reason for hiding this comment

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

Typo: "an dictionary" should be "a dictionary"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants