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

672 Add documentation #692

Merged
merged 195 commits into from
Jun 22, 2020
Merged

672 Add documentation #692

merged 195 commits into from
Jun 22, 2020

Conversation

lifflander
Copy link
Collaborator

@lifflander lifflander commented Feb 13, 2020

Fixes #672

Finally done... Docs for all components in VT. All the meta-docs pages for DARMA website.

You won't be able to see all the nice generated documentation until this gets merged. The auto-build will generate the docs publicly once that happens. Here's screenshot of what the home page looks like:

When it's merged, it will end up here: https://darma-tasking.github.io/docs/html/index.html

Screen Shot 2020-06-18 at 6 12 37 PM

Introduction to VT:

Screen Shot 2020-06-18 at 6 14 22 PM

The tutorial:

Screen Shot 2020-06-18 at 6 14 36 PM

@codecov
Copy link

codecov bot commented Feb 13, 2020

Codecov Report

Merging #692 into develop will increase coverage by 0.00%.
The diff coverage is 100.00%.

Impacted file tree graph

@@           Coverage Diff            @@
##           develop     #692   +/-   ##
========================================
  Coverage    80.66%   80.67%           
========================================
  Files          355      355           
  Lines        11184    11184           
========================================
+ Hits          9022     9023    +1     
+ Misses        2162     2161    -1     
Impacted Files Coverage Δ
src/vt/collective/barrier/barrier.h 100.00% <ø> (ø)
src/vt/messaging/active.h 100.00% <ø> (ø)
src/vt/objgroup/proxy/proxy_objgroup.h 100.00% <ø> (ø)
src/vt/objgroup/proxy/proxy_objgroup_elm.h 100.00% <ø> (ø)
src/vt/scheduler/scheduler.h 100.00% <ø> (ø)
src/vt/termination/termination.h 100.00% <ø> (ø)
src/vt/utils/adt/union.h 83.57% <ø> (ø)
src/vt/vrt/collection/balance/lb_invoke/invoke.h 57.14% <ø> (ø)
src/vt/vrt/collection/holders/col_holder.h 100.00% <ø> (ø)
src/vt/vrt/collection/holders/holder.h 100.00% <ø> (ø)
... and 4 more

scripts/build_vt.pl Outdated Show resolved Hide resolved
src/active-messenger.md Outdated Show resolved Hide resolved
src/active-messenger.md Outdated Show resolved Hide resolved
@PhilMiller
Copy link
Member

Who is the target audience for this documentation?

@lifflander
Copy link
Collaborator Author

lifflander commented Jun 16, 2020

Who is the target audience for this documentation?

End users of the VT api. For immediate purposes, the auditors. Also, people we bring on board who want to learn VT.

@lifflander lifflander self-assigned this Jun 19, 2020
@lifflander lifflander marked this pull request as ready for review June 19, 2020 00:50
@lifflander
Copy link
Collaborator Author

@PhilMiller Please have a look. I think I've made all the necessary changes or created issues for problems I don't want to tackle in this PR.

@lifflander lifflander requested a review from PhilMiller June 21, 2020 18:36
@PhilMiller
Copy link
Member

Revisiting it all now

@@ -207,7 +209,7 @@ struct Scheduler : runtime::component::Component<Scheduler> {
void printMemoryUsage();

/**
* \brief Enqueue a action associated with a prioritized message. The action
* \brief Enqueue an action associated with a prioritized message. The action
* will be enqueued with the priority found on the message.
*
* \param[in] msg the message
Copy link
Member

Choose a reason for hiding this comment

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

I just realized that these enqueue overloads taking message arguments are kinda quirky wrappers to do
enqueue(getPriority(msg), action). I find only a single non-test call site, in messaging/active.cc

Copy link
Collaborator Author

Codacy Here is an overview of what got changed by this pull request:

Issues
======
+ Solved 22
           

See the complete overview on Codacy

@lifflander lifflander merged commit de5e367 into develop Jun 22, 2020
pnstickne added a commit that referenced this pull request Aug 11, 2020
- sendMsg accepting MsgT*& now reassigns the pointer to null.
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.

Write documentation for VT components
3 participants