From c31244a6a4c5ff530bcfaf0159b79902c51fbd7f Mon Sep 17 00:00:00 2001 From: zlg Date: Tue, 29 Jul 2025 16:45:43 -0700 Subject: README.md: Better clarify dates, add contact details --- README.md | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 06bdd97..a89d432 100644 --- a/README.md +++ b/README.md @@ -154,14 +154,14 @@ Adds a game to the database. `NOTES` should be a fully-quoted string, with newlines escaped -`P_DATE` is an ISO8601 date string, i.e. "2025-07-27", representing the day you -purchased a game. +`P_DATE` is a string representing the date you purchased a game. * -`P_DATE` is an ISO8601 date string, i.e. "2025-07-27", representing the day you -beat a game. (i.e. saw the credits or defeated the primary antagonist) +`B_DATE` is a string representing the date you beat a game. (i.e. saw the +credits or defeated the primary antagonist) * -`C_DATE` is an ISO8601 date string, i.e. "2025-07-27", representing the day you -completed (100%d) a game. +`C_DATE` is a string representing the date you completed (100%d) a game. * + +* An ISO 8601 Date string, i.e. `2025-07-27`. --- @@ -312,6 +312,13 @@ VGStash has filters for this, too: * **`incomplete`** tracks games whose progress is beaten, but *not* completed * **`complete`** tracks games whose progress is marked completed +#### How long has that game been sitting in my backlog? + +VGStash 0.3 supports date fields for purchasing, beating, and completing a game. + +* **`backlog_age`** shows you how long each game has been in the backlog, assuming + it has a purchase date. + Check `vgstash list --help` for more. ### notes @@ -433,6 +440,11 @@ Goals planned for the 1.0 release: # Contributing -If this interests you, please [e-mail me](mailto:zlg+vgstash@zlg.space). +I'm best reachable [via e-mail](mailto:zlg+vgstash@zlg.space), but I can also be +found on [Twitch](https://twitch.tv/zlg_creates), +[Ko-Fi](https://ko-fi.com/zlg_creates), and [my own website](https://zlg.space). + +Actual contributions should be e-mailed in a git-friendly patch format, so I can +use `git am` to easily merge it. Thank you for your consideration. [spdx-agpl3]: https://spdx.org/licenses/AGPL-3.0-only.html -- cgit v1.2.3-70-g09d2 >/src (unfollow)
AgeCommit message (Expand)AuthorFilesLines
2019-04-29setup.py: Remove obsolete informationzlg1-1/+0
2019-01-03vgstash: Add "notes" filter to schemazlg1-1/+2
2018-11-21Prepare for distributionzlg2-1/+3
2018-10-22vgstash: let backlog filter ignore unbeatable gameszlg1-1/+1
2018-10-18Bump to 0.3beta2 for PyPIzlg1-3/+3
2018-10-18vgstash.DB.__init__: fix error output formattingzlg1-1/+1
2018-10-18README: fix inline <code> formattingzlg1-3/+4
2018-10-18cli: show msg if game to be deleted is not in DBzlg2-2/+12
2018-10-18README: expand on usage, cover shell quotingzlg1-7/+99
2018-10-18cli: Tell the user when a game lacks noteszlg2-3/+15
2018-10-18Catch when an invalid list filter is passedzlg4-3/+24
2018-10-12cli: Add zero-game import/export messageszlg2-11/+18
2018-10-10Bump to 0.3beta1 for PyPIzlg1-1/+1
2018-10-10Move tests and data to dedicated directoryzlg7-10/+26
2018-10-10cli: Add "export" commandzlg2-5/+54
2018-10-10cli: Add "import" commandzlg5-1/+76
2018-10-09Bump to 0.3alpha6 for PyPIzlg1-1/+1
2018-10-09cli: Add "notes" commandzlg2-4/+74
2018-10-09update_game: ensure notes are also savedzlg1-2/+2
2018-10-09cli: add 'update' commandzlg3-20/+92
2018-10-06cli: Add "delete" commandzlg2-0/+19
2018-10-06Remove ID field from DBzlg3-38/+46
2018-10-06cli: change "Status" heading to "Progress"zlg2-36/+40
2018-09-29Bump to 0.3alpha5 for PyPIzlg1-1/+1
2018-09-29cli: Add pretty printing to 'list' commandzlg3-17/+107
2018-09-08setup.py: Bump to alpha4 for PyPIzlg1-1/+1
2018-09-08cli: add '--raw' option to list commandzlg2-9/+45
2018-09-08Add remaining filters to vgstash packagezlg1-2/+11
2018-09-04Update LICENSE to match setup.pyzlg1-80/+67
2018-09-03Branch off from master with pytest, tox, clickzlg16-778/+779
2018-03-18Flesh out filter types and ownership statuszlg3-82/+144
2018-03-18README.mdown: break line correctlyzlg1-1/+1
2018-03-18add 'playlog' list filterzlg2-2/+9
2018-03-13Update helpers a bitzlg1-2/+9
2018-03-13Make VGSTASH_DB_LOCATION point to a filezlg2-21/+20
2016-11-18Remove settings from helpers.shZe Libertine Gamer1-5/+0
2016-11-15Correct phrasing in README.Ze Libertine Gamer1-4/+4
2016-11-13DerpZe Libertine Gamer1-0/+1
2016-11-03Improve error handling in shell scriptsZe Libertine Gamer4-3/+23
2016-10-24Correct run_again, add recursionZe Libertine Gamer1-0/+4
2016-10-21Add quotes to correct behavior for arglistZe Libertine Gamer1-1/+1
2016-10-14updater.sh: add recursion, error handlingZe Libertine Gamer1-43/+101
2016-10-14Correct pipe-handling behaviorZe Libertine Gamer1-1/+9
2016-10-12Clarify a method to move between platformsZe Libertine Gamer1-2/+5