Changelog tutorial

Place to get help with not working mods / modding interface.
User avatar
Optera
Smart Inserter
Smart Inserter
Posts: 2330
Joined: Sat Jun 11, 2016 6:41 am
Contact:

Re: Changelog tutorial

Post by Optera »

jockeril wrote:
Wed Jan 15, 2020 3:29 pm

Can you make it so that either the first tab/category is selected or better yet - have the All category tab first and selected and the rest follow alphabetically ?

And I'd like to +1 the Idea of showing the latest update first and the rest in descending order as is customary in most software change logs you find.
+1 on both
Now that you pointed it out I'll always be bothered by All tab not being the first tab.

Pi-C
Filter Inserter
Filter Inserter
Posts: 487
Joined: Sun Oct 14, 2018 8:13 am
Contact:

Re: Changelog tutorial

Post by Pi-C »

jockeril wrote:
Wed Jan 15, 2020 3:29 pm
@Pi-C - I love your post and use it every time I make a change to my mods (bc I don't do that often and always have a parsing problem somewhere with a new entry in the change log file... :evil: )
Thanks for the compliment -- and for keeping your changelogs working! :-D
@Devs - I think there is a minor issue with ow the change log is presented in the game interface where the categories are ordered strangely (PSB my example picture):
[snip]

Can you make it so that either the first tab/category is selected or better yet - have the All category tab first and selected and the rest follow alphabetically ?
I'm not a developer, but there is a certain logic to the current layout: Everything before All is an "official" category used by the vanilla game, everything after it is a "custom" category (or a typo, e.g. "Bugfix" instead of "Bugfixes"), so "All" serves as a separator. The "All" tab is selected because you usually want to see everything at once, without having to click on every tab. Perhaps I've just gotten used to the current behavior, but if this would indeed be changed, I'd opt for the second suggestion (All tab first, official and custom categories mixed and following All in alphabetic order).

And I'd like to +1 the Idea of showing the latest update first and the rest in descending order as is customary in most software change logs you find.
Again, I've become used to the current order: When I install a new mod, I don't want to scroll to the bottom, start reading at the last entry and work my way upwards. It's different with updating mods, though: Having to scroll down to get to the latest changes can be a PITA if the changelog is as long as some of my own have become. :-)

Instead of always sorting the entries one way only (be it first to last or last to first), I'd wish for a toggle button so you can sort the entries in whatever way is best for you at the moment. Something like that exists already in the "Install" section, where you can sort mods by name, version, last update etc.
A good mod deserves a good changelog. Here's a tutorial (WIP) about Factorio's way too strict changelog syntax!

Schallfalke
Fast Inserter
Fast Inserter
Posts: 128
Joined: Sun Oct 28, 2018 7:57 am
Contact:

Re: Changelog tutorial

Post by Schallfalke »

jockeril wrote:
Wed Jan 15, 2020 3:29 pm
@Devs - I think there is a minor issue with ow the change log is presented in the game interface where the categories are ordered strangely (PSB my example picture):

Change log category order.JPG


Can you make it so that either the first tab/category is selected or better yet - have the All category tab first and selected and the rest follow alphabetically ?
I am not from dev team, but I can answer (partially) your questions.
There is a list of "supported" fields, as listed by Bilka's post on the first page of this thread.

There is some "hard-coded" order of the supported fields, where "All" field is the last one among them.
Any fields not in the list (such as your "Fix" and "To Do") will show after these supported fields.

EDIT: Did not see Pi-C's reply when posting this... But anyway...

Honktown
Filter Inserter
Filter Inserter
Posts: 479
Joined: Thu Oct 03, 2019 7:10 am
Contact:

Re: Changelog tutorial

Post by Honktown »

Heh, triggered a very minor "bug":
image
To stay on topic, any know of a changelog pretty printer, that works for both website and in-game? They have different widths which makes some things awkward, I usually just shorten my lines a bit and gently cascade indentation if I need to (or I'd be eating up a lot of space...). I've never used LaTeX, but I've seen a bit of it. Probably wouldn't mind using something which parsed that into a pretty-printed changelog. I can make a pretty-printer myself, just looking for a "standard" tool (markdown, LaTeX, etc). Don't mind if it's sh, bat, perl, what have you.
I have mods! I guess!
Link

Pi-C
Filter Inserter
Filter Inserter
Posts: 487
Joined: Sun Oct 14, 2018 8:13 am
Contact:

Re: Changelog tutorial

Post by Pi-C »

Honktown wrote:
Thu Jan 16, 2020 8:18 pm
Heh, triggered a very minor "bug":
Interesting. I'll play around with that later. :-)
To stay on topic, any know of a changelog pretty printer, that works for both website and in-game? They have different widths which makes some things awkward, I usually just shorten my lines a bit and gently cascade indentation if I need to (or I'd be eating up a lot of space...).
Impossible, I'd say! Websites are dynamic stuff, as author of web content, you don't have control about anything while you can control everything for print media. As author of web content, you don't know how big my monitor will be (e.g. huge monitor vs. small smartphone screen), you don't know whether I'll maximize my browser window, whether I'll use zooming or whether I'll overwrite the fonts you've so carefully chosen with a default style that I like. Heck, you can't even be sure I'll use a graphic browser -- perhaps I've just fired up elinks because it takes so long until Firefox has loaded all the tabs. Anyway, believing that you can control what the output in any browser but your own will look like is an illusion. :-)

You have a bit more control with the in-game-viewer, I guess, because Factorio should at least provide the same fonts to everybody. Still, line lengths will vary with screen and window size.

In my opinion, the best thing you can do is conform with the game parser's rules and just forget about how it looks on the mod portal.
A good mod deserves a good changelog. Here's a tutorial (WIP) about Factorio's way too strict changelog syntax!

User avatar
BlueTemplar
Smart Inserter
Smart Inserter
Posts: 1977
Joined: Fri Jun 08, 2018 2:16 pm
Contact:

Re: Changelog tutorial

Post by BlueTemplar »

Yeah, one weakness of (Lua)(La)TeX is that (AFAIK) it only outputs to DVI / PostScript / PDF, which, (AFAIK) being locked to fixed page sizes, are (literally) a poor fit for digital-only documents !

Markdown's much smaller feature list is much more feasible of course... but is it worth it for the devs to spare their time for that ?

Post Reply

Return to “Modding help”

Who is online

Users browsing this forum: No registered users