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

Document Snake Tutorial Blocks #180

Merged
merged 17 commits into from
May 3, 2022
Merged

Document Snake Tutorial Blocks #180

merged 17 commits into from
May 3, 2022

Conversation

satendrapalsingh
Copy link
Contributor

Raising a draft PR to recieve early feedback on GUI.Text documentation. Other block documentation in progress.

@codecov
Copy link

codecov bot commented Mar 14, 2022

Codecov Report

Merging #180 (e48db20) into devel (d9ea433) will increase coverage by 0.05%.
The diff coverage is 100.00%.

❗ Current head e48db20 differs from pull request most recent head f583f79. Consider uploading reports for the commit f583f79 to get more accurate results

@@            Coverage Diff             @@
##            devel     #180      +/-   ##
==========================================
+ Coverage   70.63%   70.68%   +0.05%     
==========================================
  Files          59       59              
  Lines       23083    23125      +42     
==========================================
+ Hits        16304    16346      +42     
  Misses       6779     6779              
Impacted Files Coverage Δ
src/core/blocks/core.cpp 85.53% <100.00%> (+0.21%) ⬆️
src/core/blocks/core.hpp 69.46% <100.00%> (+0.30%) ⬆️
src/core/blocks/flow.cpp 89.79% <100.00%> (+0.01%) ⬆️
src/core/blocks/logging.cpp 89.04% <100.00%> (+0.98%) ⬆️
src/core/blocks/math.hpp 86.91% <100.00%> (ø)
src/extra/imgui.cpp 67.21% <100.00%> (+0.04%) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d9ea433...f583f79. Read the comment docs.

@satendrapalsingh satendrapalsingh force-pushed the docs_blocks branch 2 times, most recently from 8c0a5e1 to db25e5e Compare March 25, 2022 09:40
@satendrapalsingh satendrapalsingh changed the title Document block GUI.Text Document Snake Tutorial Blocks Mar 25, 2022
@Kryptos-FR Kryptos-FR added the Project: Documentation Improvements or additions to documentation label Mar 30, 2022
Copy link
Contributor Author

@satendrapalsingh satendrapalsingh left a comment

Choose a reason for hiding this comment

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

@sinkingsugar , @Kryptos-FR , @guusw - Should I remove the note I have added in Details page for "Binary operations on sequences" ? I added it to explain how such binary operations on sequences could useful in computing table values. But maybe talking about 2D/3D grids might confuse the user w.r.t to the already existing matrix multiplication operator Math.MatMul, no?

*Talking about this commit

@satendrapalsingh satendrapalsingh force-pushed the docs_blocks branch 5 times, most recently from 51c6db5 to 3734305 Compare April 27, 2022 05:24
docs/samples/blocks/GUI/Text/1.edn Outdated Show resolved Hide resolved
docs/details/blocks/GUI/Window.md Outdated Show resolved Hide resolved
docs/samples/blocks/GUI/Window/1.edn Outdated Show resolved Hide resolved
docs/details/blocks/Math/Add.md Outdated Show resolved Hide resolved
docs/details/blocks/Math/Add.md Outdated Show resolved Hide resolved
docs/details/blocks/Math/Multiply.md Outdated Show resolved Hide resolved
docs/details/blocks/General/Sub.md Outdated Show resolved Hide resolved
docs/details/blocks/General/Sub.md Outdated Show resolved Hide resolved
@satendrapalsingh satendrapalsingh force-pushed the docs_blocks branch 5 times, most recently from 8386aca to 613b8fe Compare April 28, 2022 19:01
@satendrapalsingh
Copy link
Contributor Author

Addressed all review comments and fixup'd the commits.

> Add definition
> Rewrite parameter definitions for clarity
> Add sample codes to explain the block
> Add details section
satendrapalsingh and others added 15 commits May 3, 2022 00:12
Specifically for `Math.Add` & `Math.Multiply` (and in general for all Math binary operators), ehance the
> definition text
> `:Input` description
> `:Operand` parameter description
For both `Math.Add` & `Math.Multiply`:
> add sample codes covering all scenarios of inputs (integers, floats, sequences)
> add explanatory comments to sample codes
For both `Math.Add` & `Math.Multiply`:
> add details section explaining the binary operation and arguments
> add a note on binary operation on sequences
Remove special character from the end of the URL
> Add the details section to explain how block works
> Add sample code to illustrate block usage
> Enhance parameter description
> Add the details section to explain how block works
> Add sample code to illustrate block usage
> Enhance parameter description
> New definition text inserted for block `Log`
> New definition text inserted for block `Msg`
> Enhance definition, parameters, input, & output descriptions
> Add details section
> Add relevant code samples to illustrate block usage
> Enhance definition, parameters, input, & output descriptions
> Add details section
> Add relevant code samples to illustrate block usage
> Enhance parameter help text
> Add definition, inputTypes, and outputTypes description text
> Add sample code to demonstrate block usage
> Enhance parameter help text
> Add definition, inputTypes, and outputTypes description text
> Add sample code to demonstrate block usage
> Enhance parameter help text
> Add definition, inputTypes, and outputTypes description text
> Add sample code to demonstrate block usage
> Enhance parameter help text
> Add definition, inputTypes, and outputTypes description text
> Add sample code to demonstrate block usage
> Enhance parameter help text
> Add definition description text
> Add sample code to demonstrate block usage
@satendrapalsingh satendrapalsingh marked this pull request as ready for review May 2, 2022 19:05
@satendrapalsingh satendrapalsingh merged commit 7fa3e42 into devel May 3, 2022
@satendrapalsingh satendrapalsingh deleted the docs_blocks branch May 8, 2022 08:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Project: Documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants