[Aftershock] Design Doc Draft

[Maleclypse]

Summary

SUMMARY: Mods "Aftershock Design Doc"

Purpose of change

Update design doc to reference the ongoing total conversion mod direction that Aftershock is taking.

Describe the solution

Updates Readme.MD. First draft. Putting some words to paper. Open to suggestions. @Mom-Bun

Describe alternatives you've considered

None

Testing

N/A

Additional context

[actual-nh]

Interesting! I am looking forward to further developments (and helping with a few).

[Mom-Bun]

Let me take a look at this, but one thing that stands out to me is the "here be dragons" section

Do we need this? It just identifies where files go, and a quick "git grep" or asking maintainers could figure out where everything goes I think?

[Maleclypse]

Let me take a look at this, but one thing that stands out to me is the "here be dragons" section

Do we need this? It just identifies where files go, and a quick "git grep" or asking maintainers could figure out where everything goes I think?

That's a question you can ask, it will cause me to ask questions about your parentage and how you are exceptionally polite for someone raised by wolves, who doesn't believe in Table of Contents. I am a firm believer in tables of contents and that as a mod grows in size they become even more important as eventually we may need to use those ToC spaces to explain design choices and request additional content from contributors. :)

[actual-nh]

Let me take a look at this, but one thing that stands out to me is the "here be dragons" section

Do we need this? It just identifies where files go, and a quick "git grep" or asking maintainers could figure out where everything goes I think?

It is also a bit out of date - item groups are under, well, itemgroups, not under maps.

[Mom-Bun]

Overall this looks good for the first draft!
I'll be keeping an eye on this, and if anything stands out I'll make sure to note a review of it!

[Mom-Bun]

Let me take a look at this, but one thing that stands out to me is the "here be dragons" section
Do we need this? It just identifies where files go, and a quick "git grep" or asking maintainers could figure out where everything goes I think?

That's a question you can ask, it will cause me to ask questions about your parentage and how you are exceptionally polite for someone raised by wolves, who doesn't believe in Table of Contents. I am a firm believer in tables of contents and that as a mod grows in size they become even more important as eventually we may need to use those ToC spaces to explain design choices and request additional content from contributors. :)

Hahaha completely fair, I was mostly asking as there wasn't a table of contents in regular dda, or any other mod from what I know, so I was curious, but that makes sense considering how big this mod will end up being; so I'm alright with keeping it.

[Mom-Bun]

Oh another important thing, have you included something specifying how aftershock isn't a dumping mod?

[Maleclypse]

Oh another important thing, have you included something specifying how aftershock isn't a dumping mod?

I haven't for a couple of reasons.

1. I'm not super concerned about it, because the more truly different style content we add the more obvious it becomes that anyone saying that doesn't have a clue what they are talking about. I get that we haven't deployed the insanely different stuff like biomes yet.
2. Because I'm not super worried I can't think of any phrasing that doesn't feel like we are "protesting too much".
3. I'm strangely more concerned that I'll be more frustrated if I spend time writing "this is not a dump mod" when people inevitably ask questions about "aftershock the dump mod".

Anyway I'm totes fine with someone else writing up some kind of dump mod disavowal bur I'm not gonna worry about it in this PR.

[Mom-Bun]

Oh another important thing, have you included something specifying how aftershock isn't a dumping mod?

I haven't for a couple of reasons.

1. I'm not super concerned about it, because the more truly different style content we add the more obvious it becomes that anyone saying that doesn't have a clue what they are talking about. I get that we haven't deployed the insanely different stuff like biomes yet.
2. Because I'm not super worried I can't think of any phrasing that doesn't feel like we are "protesting too much".
3. I'm strangely more concerned that I'll be more frustrated if I spend time writing "this is not a dump mod" when people inevitably ask questions about "aftershock the dump mod".

Anyway I'm totes fine with someone else writing up some kind of dump mod disavowal bur I'm not gonna worry about it in this PR.

Ah those reasons make sense, yeah!

Alright, this draft looks good by me then, as it mentions everything important so far :)

[kevingranade]

Just FYI, once this is where you want it, we could put it on cataclysmdda.org for higher visibility.

[Mom-Bun]

Just FYI, once this is where you want it, we could put it on cataclysmdda.org for higher visibility.

Just to note, if the other maintainers don't object to it of course, I would love to have it on the site yea.

[NoahGoldFox]

Will there eventually be a version of aftershock that includes just more sci-fi stuff without the full conversion? for people who do want sci-fi but not a whole conversion.

[Mom-Bun]

Will there eventually be a version of aftershock that includes just more sci-fi stuff without the full conversion? for people who do want sci-fi but not a whole conversion.

In-repo, no.

You can always copy and paste the sci-fi stuff yourself and put it into a mod without the conversion stuff however.