Maneage - Tasks: task #15591, Tutorials for the beginner and...
You are not allowed to post comments on this tracker with your current authentication level.
task #15591: Tutorials for the beginner and intermediate user
Submitter: | Raul Infante-Sainz <infantesainz> | ||
Submitted: | Wed 08 Apr 2020 10:02:34 PM UTC | ||
Should Start On: | Wed 08 Apr 2020 12:00:00 AM UTC | Should be Finished on: | Wed 08 Apr 2020 12:00:00 AM UTC |
Category: | Webpage | Priority: | 5 - Normal |
Status: | None | Privacy: | Public |
Percent Complete: | 20% | Assigned to: | None |
Open/Closed: | Open | Effort: | 0.00 |
( Jump to the original submission )
Wed 23 Jun 2021 11:20:18 PM UTC, comment #7: |
Mohammad Akhlaghi <makhlaghi>![]() |
Tue 22 Jun 2021 04:22:54 PM UTC, comment #6: This wasn't in the repository before. But just now I pushed commit 31e38ea2b2 on my gitlab repository that contains the md2html.bash and a github-ish style. There is more detail in the scripts about the source :) Please let me know if you have any questions.
|
Pedram Ashofteh-Ardakani <pedram>![]() |
Tue 22 Jun 2021 03:35:19 PM UTC, comment #5: hi Pedram! Is this source in one of the git repositories? I'm not volunteering to do any tutorials on any short time scale, and I don't really mind either markdown + hacking or direct html, but this would be useful to know for anyone willing and finding time to do the work. :)
|
Boud Roukema <boud>![]() |
Tue 22 Jun 2021 03:11:04 PM UTC, comment #4: Hi, the markup to HTML conversion was semi-automatic, using this script. Semi-automatic, because it failed to recognize some styles. Maybe we can use other more accurate scripts, and update the HTML automatically :) |
Pedram Ashofteh-Ardakani <pedram>![]() |
Tue 22 Jun 2021 02:59:20 PM UTC, comment #3: Following an idea by Mohammadreza, having a very short minimal tutorial would be good.
|
Boud Roukema <boud>![]() |
Tue 22 Jun 2021 02:53:49 PM UTC, comment #2: Just to update this. We have had a tutorial in place at https://maneage.org/tutorial.html for quite some time now.
|
Boud Roukema <boud>![]() |
Wed 22 Apr 2020 07:29:36 PM UTC, comment #1: Indeed, this is quite nice! Providing clear and extensive documentation to train non-experienced users is critical for promoting software.
|
Pedram Ashofteh-Ardakani <pedram>![]() |
Wed 08 Apr 2020 10:02:34 PM UTC, original submission:
It would be nice to have some tutorials with different level of difficult in order to show how to use Maneage in practice. For example, a very first basic tutorial explaining how Make works with very basic examples. Second tutorial showing how to include Makefiles and make an small analysis of a dataset in Maneage. Finally, a third tutorial a bit more difficult showing how to deal with multiple files using Makefile pattern match (for parallelizing). This is just ideas that are in my mind but it is open to be discussed.
|
Raul Infante-Sainz <infantesainz>![]() |
No files currently attached
Depends on the following items: None found
Items that depend on this one: None found
There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.
Thanks for raising this issue Boud.
Since the main job (a tutorial) is done (for an advanced user), I changed the title to "Tutorials for the beginner and intermediate user".
About the formatting of the Maneage documentation, we are already planning to use Texinfo in task #15825. So let's not waste time trying to convert Markdown ;-).
I should get that task started as soon as possible! There are just too many things to do :-(. If anyone would like to volunteer for that task, please take the lead ;-).