Open
Conversation
…int and easier to digest
… guides for near-future use. WIP
…e; prepare ground for importing users;
…-first-steps to sync it with latest master changes
…lish phrasing here and there
…change heading structure for clarity; describe mapping naming policices
Because we decided they need to be versioned and thus kept in midpoint/reference. The deleted stubs were worthless in their current state and, thus, could be safely deleted as such.
We don't have a suitable tutorials yet as I had to put the work on GUI guides section on hold to create it in the versioned docs section.
Also adjust (grammar/language) in the Multiple source article.
edison23
commented
Jan 7, 2026
midpoint/methodology/first-steps/bonus-points/multiple-sources.adoc
Outdated
Show resolved
Hide resolved
Consequence of Evolveum/midpoint/4079bef4db1039239c468722b0ff1628b6f093e6 Which was possible thanks to restructuring the article so that anchoring to that heading is not needed anymore.
The redirects have been decided based on the content similarity. Sometimes (e.g., in the case of audience), the content is not under the 1st heading in the target page, and other times, the old big article was split into multiple articles or even sections (Assessment). In such a case, the redirect leads to the first section.
Newly using the diagram from the 1st3ps methodology training slides to help people see the connection between the training and the tutorial in the Docs.
Change the article title to include the "kick-off" keyword in order to help people see the connection between the training and the tutorial in the Docs.
- Methodology is the theoretical part, similar to how the original 1st3ps methodology was designed - Training is the practical part showcasing the theory on concrete applications (HRIS and AD/LDAP), closely following the original MID-301 course The two are not entirely independent but they target different audience (business vs. technical persona) and are of a different content type (conceptual talk vs. tutorials)
- I have decided to retract renaming the folder of the methodology section of 1st3ps because I have realized it would mean high amount of link updates across the whole Documentation (including all branches in the `midpoint` repo). The ROI of such a change does not seem reasonable to me. The display name remains, link path stays the same. The training section continues to be the new `first-steps-training`. - I have updated all xref paths in the methodology and training according to the new structure.
- It is not "a guide" as a whole now since it has two parts -> adjusted wording of intro articles accordingly - Fixed a few typos (thx to @dejavix)
This is particularly important for the section overview table used in the `first-steps-training/index.adoc`.
Contributor
Author
|
@licehammer , @dejavix : Since our review session, I have implemented what we have agreen on:
The commit directly related to our discussion last week:
Please kindly review the adjustments and let me know if they are in agreement with the vision you have for First steps. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR presents the completely reworked First steps methodology. My goal was to make the guide work as a standalone series of articles (modules) that are independent on the video presentations in the original MID-301 First steps training (unlike the original 6-article First steps methodology we currently have in the Documentation). One of the reasons is that I believe it may be for many users more comfortable and beneficial to follow a textual guide rather than watching videos because following text guides supports the learning process better, I think. I used the original training as a foundation for the content in the First steps guide I have written.
I would hereby like to kindly ask for a review of my work here. I would be grateful for validation (or rejection for that matter) of the learning flow, the value for learners, and for pieces of advice on what can possibly be improved in that regard, as I find the flow and learning value the most important aspects of such a guide. However, I will be happy to hear any remarks, of course.
I am assigning this to you, @dejavix , since the original course is your work, but please feel free to delegate as you see fit; I am aware it is a lot of content and the time invenstment is substantial. Obviously, I count on the fact the review may take some time, that is completely fine.
I am tagging for visibility @licehammer and @jirihuf .