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

The terms chapter is missing many terms we would like to see added for MPI-4 #96

Closed
tonyskjellum opened this issue Jun 14, 2018 · 40 comments
Assignees
Labels
had reading Completed the formal proposal reading passed final vote Passed the final formal vote passed first vote Passed the first formal vote wg-persistence Persistence Working Group wg-terms Semantic Terms Working Group
Milestone

Comments

@tonyskjellum
Copy link

tonyskjellum commented Jun 14, 2018

Problem

When reviewing the terms chapter to clarify issues for persistent/persistence (which was not defined there) and adding focused new changes to support persistence, we discovered that there are evidently many missing terms. In preparing for the MPI-4 release, a complete glossary with definitions (some which may just be later in the standard) is missing. What is more, the use of some terms are used interchangeably in the standard, and it might be necessary to review the entire proposal text once the glossary is updated, to uniformize certain terminology for clarity.

No such changes will make functional changes in MPI-4, but we want the standard to be understandable to non-experts.

Proposal

Add a full glossary of terms, clarify existing terms, add missing terms (e.g., buffer). Clarify the differences between operations, procedure calls (aka procedures, aka calls), etc. A thorough study of all useful glossary terms and standardized definitions should be here.

Changes to the Text

The terms chapter will be revised and extended. Once that's done, it may be useful for chapter authors to review the terms, and make sure each chapter complies with the terminology as clarified. No non-editorial changes are expected from such a review.

Impact on Implementations

None.

Impact on Users

Users will be able to understand the standard better.

References

Ticket #90 addresses limited editions to the same chapter.

PR https://github.com/mpi-forum/mpi-standard/pull/116 provides the official changes for this ticket.

Presentation that provides the motivation for this issue:
SemanticTerms-Motivation-06020202.pdf

PDF file used for successful reading (including the changes from no-no-votes): mpi40-report-ticket96-98f6380-01july2020.pdf

Latest PDF file: mpi40-report-ticket96-5ccf3e4-18Aug2020.pdf

Presentation on additional topics for MPI 4.1 and related discussion can be found here:
SemanticTerms-4.1-Discussion.pdf

@tonyskjellum tonyskjellum added mpi <next> no-wg Discussion doesn't have a current working group labels Jun 14, 2018
@puribangalore
Copy link

Attached is the PDF file that incorporates the changes to Semantic Terms section and corresponding updates to other chapters.
mpi32-report.pdf

@RolfRabenseifner
Copy link

Annotated version of the mpi32-report.pdf from Puri:
mpi32-report-semantic-terms-2019-02-18-annotated.pdf

A pdf with all changes together, including the proposal for the Annex A.2:
MPI-semantics_2018-11-06_proposal.pdf

Proposale for new additional Annex A.2:
MPI-semantics-appendix.pdf

@RolfRabenseifner RolfRabenseifner added the scheduled reading Reading is scheduled for the next meeting label Feb 18, 2019
@RolfRabenseifner
Copy link

Annotated version, now also including new Annex A.2 and the change-log entry
mpi32-report-semantic-terms-2019-02-18a-annotated.pdf

@RolfRabenseifner
Copy link

mpi32-report-semantic-terms-2019-03-27-annotated.pdf
This annotated version was used in the virtual meeting, March 27, 2019

@RolfRabenseifner
Copy link

The following pdf is the result of the discussion at the virtual meeting on March 27, 2019:
mpi32-report-semantic-terms-2019-04-12-annotated.pdf

@RolfRabenseifner
Copy link

The following pdf includes the proposals for changes in the pull request 97 plus some additional enhancments plus a new text for MPI_REQUEST_FREE that fits better to the new terms and is more exact in the case of freeing inactive requests.
mpi32-report-semantic-terms-2019-04-14-annotated.pdf

@RolfRabenseifner
Copy link

The following pdf includes all changes from and since the telcon on April 14 until now, May 07, 2019.
Additionally, I updated the Annex column about complete/incomplete for all Wait/Test/free routines according to the rule that before freeing, the routines are still incomplete, because freeing stage is still missing.
mpi32-report-semantic-terms-2019-05-07-annotated.pdf

@RolfRabenseifner
Copy link

The following pdf should be the draft used for the formal reading at the Chicago meeting May 28-31, 2019.
The working-group internal many-color-bars are now substituted by one color for the reading.
Latest changes were the more accurate wording on page 13, lines 18-24. And we added page 835 lines 36-38 to the change-log.
mpi32-report-semantic-terms-2019-05-08-annotated.pdf

@RolfRabenseifner
Copy link

Update for the Chicago reading:
mpi32-report-semantic-terms-2019-05-12-annotated.pdf

@puribangalore
Copy link

puribangalore commented May 13, 2019

Updated and annotated PDF file.
mpi32-report-issue96-annotated.pdf

I made few minor fixes to the change-log and legends for the appendix table. Also, the version Rolf is using is behind the current mpi-3.x repo.

@RolfRabenseifner
Copy link

Updated with change-bars instead of yellow marker. Added "#96" as marker at all changes
mpi32-report-semantic-terms-2019-05-13-annotated-bars.pdf

@puribangalore
Copy link

Updated PDF file with changes from Chicago MPI Forum meeting: mpi32-report.pdf

@puribangalore
Copy link

Here is the latest PDF file for Zurich MPI Forum meeting:
mpi32-report.pdf

@RolfRabenseifner
Copy link

RolfRabenseifner commented Apr 7, 2020

During the meeting, we made several small changes to the version from Feb. 02, 2020.
They are added as comments the original pdf:

mpi-report-issue96-2020-02-02-annotated+2020-02-18+19+21.pdf

These changes were added to the PR 116. During the re-reading, several additional comments were added. At the end of the Portland meeting (Feb 18-21, 2020), I forgot to upload the final version of the pdf that included the comments from the reading:

mpi-report-issue96-2020-02-20c-a0163c7-reading-notes-printable.pdf

@RolfRabenseifner
Copy link

The latest Version (May 20, 2020) includes:

  • includes the version from Feb, 2, two weeks before Portland meeting,
  • plus small corrections from the meeting and since then.

mpi32-report-semantic-terms-2020-05-20-annotated.pdf

@RolfRabenseifner
Copy link

Introduction slides for the MPI Forum (virtual Meeting May 20, 2020):
EuroMPI2019-SematicTerms-fromPuri-2020-04-28_rab-2020-05-20.pdf

@RolfRabenseifner
Copy link

RolfRabenseifner commented May 31, 2020

Since Portland meeting, four parts of small changes were added.
The version May 20, 2020:

The version May 31, 2020:

These Parts I-IV of small changes are documented in the following slides:

@RolfRabenseifner
Copy link

Latest annotated versions for the reading at the exceptional virtual meeting in June 2020:

Version-1:
mpi40-report-520db9c-june2020-reading-v1-annoteted.pdf

Version-2:
mpi40-report-f51be45-june2020-reading-v2-annotated.pdf

@RolfRabenseifner
Copy link

RolfRabenseifner commented Jun 27, 2020

Latest annotated Version 3 for the reading at the exceptional virtual meeting in June 2020:

mpi40-report-june2020-reading-v3-annotated.pdf

It has mainly one small change compared to Version 2.

@puribangalore puribangalore added had reading Completed the formal proposal reading scheduled vote and removed scheduled reading Reading is scheduled for the next meeting labels Jul 1, 2020
@puribangalore puribangalore added wg-terms Semantic Terms Working Group and removed no-wg Discussion doesn't have a current working group labels Jul 1, 2020
@wesbland
Copy link
Member

wesbland commented Jul 11, 2020

This passed a "no no" vote on 2020-06-30.

https://www.mpi-forum.org/meetings/2020/06/votes

@wesbland
Copy link
Member

This passed a "no no" vote on 2020-07-01.

https://www.mpi-forum.org/meetings/2020/06/votes

@wesbland
Copy link
Member

This passed a "no no" and first vote on 2020-08-19.

https://www.mpi-forum.org/meetings/2020/08/votes

@wesbland
Copy link
Member

@puribangalore - This is scheduled for a second vote at the September meeting, but I can't remember now, does this also need a no-no vote, or did we take care of the last of that at the August meeting? I think we took care of it all, but I want to be sure.

@puribangalore
Copy link

The no-no-vote was already taken at the August meeting and there are no more changes, at least as of today.

@wesbland wesbland added the passed final vote Passed the final formal vote label Sep 28, 2020
@wgropp wgropp closed this as completed Sep 28, 2020
@wesbland
Copy link
Member

wesbland commented Oct 1, 2020

This passed a second vote on 2020-09-28.

https://www.mpi-forum.org/meetings/2020/09/votes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
had reading Completed the formal proposal reading passed final vote Passed the final formal vote passed first vote Passed the first formal vote wg-persistence Persistence Working Group wg-terms Semantic Terms Working Group
Projects
None yet
Development

No branches or pull requests

8 participants