Writing a better changelog for our mods

[Charriu]

Well the title already gives it away. I'm planning to rewrite the changelogs for our mods RtR and CtH. The problem and question at hand is, how should this new changelog look.

So I ask you what are some things that bother you in particular?
What could be done better?

For example one thing that bothers me in the CtH log is that in order to make the log shorter I hid a lot of civ changes in other parts.

[NobleHelium]

I think it is better to put the same change in multiple locations if it applies to multiple "categories." It's better than people not being aware of a change to the Pyramids because they were looking under the Wonder section and not under the Trait (IND) section, for example.

[Cyneheard]

Well the title already gives it away. I'm planning to rewrite the changelogs for our mods RtR and CtH. The problem and question at hand is, how should this new changelog look.

So I ask you what are some things that bother you in particular?
What could be done better?

For example one thing that bothers me in the CtH log is that in order to make the log shorter I hid a lot of civ changes in other parts.

Also relevant:

Complexity is a different axis from length.

The two are related, but they can be distinct.

[Charriu]

I'm thinking more about changing the layout and structure again. One thing I'm wondering about are things like these:

Agriculture: Cost 40 instead of 60

Is it important for you to know from which value I came? For example I could simplify to this:

Agriculture: Cost reduced to 40

[Thoth]

Is it important for you to know from which value I came?

Important? Not sure.

But it is a very nice convenience to see the original value with the changlog rather than having to look it up in game.

[Mjmd]

When you first posted this I actually made a friend who plays casually read and he also mentioned that having old values was helpful.

I then forgot to post anything.......