aboutsummaryrefslogtreecommitdiff
AgeCommit message (Collapse)AuthorLines
2020-07-07Slides prepared for RDA Spain webinar on July 9thMohammad Akhlaghi-4/+5
I also found that in the short version hadn't properly accounted for the new Git history images, and it has been corrected.
2020-07-02Using images to start discussion on Git, for IAC science coffeeMohammad Akhlaghi-151/+82
Until now, we would immeditely jump from the part on answering the project's questions to Git branches. But this isn't too useful for someone who doesn't know Git! So to start the Git branching discussion, now we first show a small image of the workflow with a "today" printed over it. Then another one with a "tomorrow". In the next slide we abstract them to circles with hashes!
2020-06-18Short slides including incrementsMohammad Akhlaghi-1/+1
2020-06-18Compled short slides, with simple macro to cut off incrementsMohammad Akhlaghi-170/+193
The short version of the slides is now ready. There is a '\longformat' macro that will significantly increase the number of slides, but not substantially (they are just the incremental things). Some minor modifications were also made in the long version.
2020-06-17First draft of short slidesMohammad Akhlaghi-3/+913
A first draft of the summarized slides was written for the talk in the RDA Adoption week.
2020-06-07Started working on short slides (10-15 minutes)Mohammad Akhlaghi-11/+110
The main slides have become too long, so a shorter version is necessary. With this commit, I am starting work on a short version.
2020-05-13Added slide with citations on reproducibility problems out of astronomyMohammad Akhlaghi-0/+20
This helps show the scale of the problem, and that its not only astronomy papers that are complaining.
2020-04-24New filename to fit with the standard name on the webpageMohammad Akhlaghi-3/+3
Since the webpage now already has `maneage' in the URL, the filename also needed to be corrected.
2020-04-24Used new Maneage webpage as host for slidesMohammad Akhlaghi-3/+3
The new `maneage.org' webpage is now displayed as the place to get the most recent slides.
2020-04-20Modified slides to use new Maneage nameMohammad Akhlaghi-73/+79
A name was finally selected for Maneage, so the slides also needed to be updated.
2020-03-05RDA Exposing Data Management Plans Working groupMohammad Akhlaghi-107/+75
2020-02-23Added quote from Di Cosmo & Pellegrini (2019) on software citationMohammad Akhlaghi-0/+5
I recently came across this quote and thought it fits nicely after the discussion on software citation.
2020-02-20Added image for GTC OsirisMohammad Akhlaghi-1/+3
2020-02-20Added image of NGC6946 for INOLAMohammad Akhlaghi-2/+4
2020-02-20For talk in IACTalksMohammad Akhlaghi-4/+126
A few slides were added in the end to show the usage of the template by various teams.
2020-02-06Added the .git/ directory to the file architecture slideMohammad Akhlaghi-2/+2
This helps connect better with the discussion on Git right after this step.
2020-02-05Updated principles sectionMohammad Akhlaghi-13/+12
The principles section was made more clear.
2020-02-01Updated slides for talk in BSCMohammad Akhlaghi-74/+69
2020-02-01Added principles before starting to describe the solutionMohammad Akhlaghi-16/+37
Until now, there wasn't any good transition onto the project, so the principles have now been added.
2020-01-29Date on new line, corrected last commitMohammad Akhlaghi-1/+1
While fixing the location, I made this mistake!
2020-01-29Prepared for talk in IAA's AMIGA groupMohammad Akhlaghi-1/+1
I will be preseinting it there tomorrow.
2020-01-28Updated copyright yearMohammad Akhlaghi-1/+1
It was still 2019, so it has been updated to 2020.
2020-01-26Data lineage plot now also includes references.texMohammad Akhlaghi-23/+23
This helps viewers feel a better connection with a standard paper.
2020-01-26More pre-displayed files in the file architecture figureMohammad Akhlaghi-0/+0
Until now, we were only showing three lower level Makefiles and configuration files, but since we don't have much Bash and Python files, I just made it four and shrank the extra space.
2020-01-22Used published version of Raul's paperMohammad Akhlaghi-2/+2
Until now, I was using the arXiv version, but now that the full PDF with the special journal format is out, I thought its better to use that.
2020-01-21Better color for directories in file architecture plotMohammad Akhlaghi-0/+0
Until now the directories were light green (similar to the Make files in the data lineage plot) which was confusing. Now that they have a different color, they can be better distinguished as directories vs. files.
2020-01-21File architecture plot in two phases, commands printedMohammad Akhlaghi-2/+36
The file architecture plot was a little crowded, so I am now first showing the files discussed in previous plots, and then showing the whole thing. Also, the 4 commands necessary to reproduce a project are added.
2020-01-20Added figure showing file architecture in projectMohammad Akhlaghi-1/+4
I just made this for the paper and thought it would be good to have here is well.
2020-01-17Minor edits in the Buckheit & Donoho quoteMohammad Akhlaghi-4/+4
The journal name and volume was added, also because its a little long, the main terms were made all-caps.
2020-01-16Added nice quote from Buckheit & Donoho (1996)Mohammad Akhlaghi-1/+15
This quote (that a paper is just an advertisement of the scholarship, not the scholarship itself) beautifully summarizes the problem!
2020-01-05Highlighed astronomer in image on replicabilityMohammad Akhlaghi-27/+83
The image that is used for replicability was intentionally chosen because it has an astronomer sitting behind the secondary mirror (showing the hard work that goes into data collection). But the image has too many details and the person can be completely missed by the viewers. So I just darkened the outer parts and added an arrow to let the audience understand the point of the image.
2020-01-03Updated copyright yearMohammad Akhlaghi-1/+1
2020-01-03Added National Academies definition on reproducibilityMohammad Akhlaghi-3/+3
The previous definition of hardware/software reproducibility was mainly my own. But I recently came across the National Academies report that gives a precise definition, so I used those terms and cited the National Academies report.
2020-01-02Added verification step in the make-demo set of slidesMohammad Akhlaghi-18/+25
A verification step was recently added to the pipeline, so it was necessary to add it here is well.
2019-12-19Described what is in every commit in slide showing Git's benefitMohammad Akhlaghi-4/+11
Since some of the audience is not yet fully familiar with Git, I thought its necessary to remind them in the slide showing Git branching, that every commit contains all aspects of the project.
2019-12-17Built steps in overall project graph made blueMohammad Akhlaghi-5/+13
Following the convention of the Make-demo plot (where green files are input and blue files are built), the first graph's gray boxes were also changed to blue. Some other minor corrections were made.
2019-12-15Make-demo slides now start from the end and come to the startMohammad Akhlaghi-67/+79
The set of slides that show how the built files relate to each other through Makefiles was edited to first show the final target, and track it all the way to the raw configuration files. This is in-line with how I describe Make (that Make starts from the end). This great suggestion was made by Idafen Santana PĂ©rez.
2019-12-07Better description of graph describing analysis stepsMohammad Akhlaghi-5/+7
To help the audience, the legend of the graph (the description at the bottom of the page) now also says that the built files are shown in the Makefiles that produces them.
2019-12-07Minor edit in NoiseChisel+M51 slide to be more clearMohammad Akhlaghi-4/+5
Until now, the connection between the first and second slides (after the title) wasn't clear, so the title and fir paragraph of the NoiseChisel+M51 slide was slightly modified to be more in-line with the previous slide.
2019-12-07Analysis demo graph using sharp-edged boxes for source filesMohammad Akhlaghi-26/+28
As Raul pointed out, to avoid confusion for a color-blind audience, or when its printed in black-and-white, its best to not just base the source-build distinction in the graph based on color. With this commit, the source files have sharp edges and the built files have round edges.
2019-12-07New slide after the analysis graph, summarizing the benefits of MakeMohammad Akhlaghi-4/+28
After showing the graph (and how everything is connected), it was useful to remind the viewers on the benefits of Make to create this structure.
2019-12-07Changed few instances of \TeX with \LaTeXMohammad Akhlaghi-2/+2
It could be confusing, but we are only using LaTeX in the template so far, so its better to just use LaTeX.
2019-12-07Better implementation of the make-demo graph, added preambleMohammad Akhlaghi-52/+95
Some minor modifications were made in the graph showing the organization of the analysis with Make. Also, a `tex/preamble.tex' was defined to simplify the main source.
2019-12-07The Make demo is now broken into multiple slidesMohammad Akhlaghi-11/+70
Until now, there was only one slide, with many boxes and arrows connecting them. It was too complicated to understand for the viewers. With this commit, it is broken up into separate slides, with each box/arrow added on each slide as we progress. This helps clearly show the logic behind all the connections. The LaTeX source of this graph is in the paper that describes the project, I will later bring that source into the slides too (and remove all the extra figures).
2019-11-25Added highted text to show relation between filesMohammad Akhlaghi-0/+66
Some arrows and text were added over the shown Makefile to better help the eye when the viewers aren't familiar with Make.
2019-11-25Changed example DOI for uploading to Zenodo in last slidesMohammad Akhlaghi-1/+1
Until now, as an example of uploading to Zenodo (besides uploading to arXiv), I was mentioning `zenodo.1164774'. But this link doesn't have any software to show. So I just updated the Zenodo link to the more recent upload of `zenodo.3408481'.
2019-11-22Slide on RDA grant moved after summary of the templateMohammad Akhlaghi-32/+32
To help in continuity with the adoption funding possibility slide, its better that the slide with the RDA grant notice is just before it.
2019-11-22Minor edit in the first slide notice on linkMohammad Akhlaghi-1/+1
The link short description above the link on the first slide is now more clear.
2019-11-21Added RDA EU 4.0's EU grant to logo and rearranged logosMohammad Akhlaghi-5/+6
Given that this project is now recieving funding from RDA EU 4.0, it was necessary to add an EU flag/description for it. With the new EU flag, it was necessary to re-arrange the logos to be more visually appealing.
2019-11-21Copyright on the README.md fileMohammad Akhlaghi-1/+21
A standard GNU GPL copyright notice was added to `README.md' to be complete.