Skip to content

Conversation

@kbriney
Copy link

@kbriney kbriney commented Sep 13, 2024

Hi!

I'm proposing a change to improve the version control example that uses file naming so that the example file names all have the same root ("manuscriptFish"). Having the same root/beginning of the file name shows that the files are related, with the appended date information showing what the major difference is between the versions. When you put date first in the file name, it makes it seem like the date is the most important thing about this set of files and then that they all happen to be on the same topic. Basically, content information should go first with version information second so that the files sort properly if mixed in with other files.

That said, I love the use of ISO 8601 on the date formatting in these file names. What a great example of how using YYYY-MM-DD makes your files sort chronologically!

Thanks,
Kristin

Updated example of version control via file naming so that the file names have the same root in common ("manuscriptFish") with the date afterward, showing that the files are the related version of the same content but from different dates.
2014-03-14_manuscriptFish_PLOSpublished.doc
manuscriptFish_2013-10-14.doc
manuscriptFish_2013-10-30.doc
manuscriptFish_2013-11-05_intitialRyanEdits.doc
Copy link
Contributor

Choose a reason for hiding this comment

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

Perhaps worth using the opportunity to fix the typo:

Suggested change
manuscriptFish_2013-11-05_intitialRyanEdits.doc
manuscriptFish_2013-11-05_initialRyanEdits.doc

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.

2 participants