Oolite Wiki

General discussion for players of Oolite.

Moderators: winston, another_commander

User avatar
maik
Wiki Wizard
Wiki Wizard
Posts: 2028
Joined: Wed Mar 10, 2010 12:30 pm
Location: Ljubljana, Slovenia (mainly industrial, feudal, TL12)

Re: Oolite Wiki

Post by maik »

Good stuff! Thanks a bunch, Cholmondely!
User avatar
Cody
Sharp Shooter Spam Assassin
Sharp Shooter Spam Assassin
Posts: 16081
Joined: Sat Jul 04, 2009 9:31 pm
Location: The Lizard's Claw
Contact:

Re: Oolite Wiki

Post by Cody »

Aye... good work, amigo!
I would advise stilts for the quagmires, and camels for the snowy hills
And any survivors, their debts I will certainly pay. There's always a way!
User avatar
Cholmondely
Archivist
Archivist
Posts: 5405
Joined: Tue Jul 07, 2020 11:00 am
Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
Contact:

Re: Oolite Wiki

Post by Cholmondely »

Updating the wiki

Hiran, since the wiki is itself unavailable at the moment, this seems like the best place for discussing how to do it.

I would suggest dividing up the OXZs by category into more manageable chunks:

Activities
Ambience
Dockables
Equipment
HUDs
Mechanics
Miscellaneous
Missions
Retextures
Ships
Systems
Weapons

From http://www.oolite.org/oxps/?sort=c

As well as the blurb, there are
(i) the tags/categories
(ii) the assessments (how the OXZ affects gameplay makes it easier or tougher - or how good one needs to be to cope with the mission or what it does to the game)
(iii) computer assessments in terms of drain on CPU & graphics creation unit
(iv) links to the BB discussion threads and the author's User page (if there is one!)

One approach might be to select a category - something short maybe like Dockables, or something that really appeals to you - and then either we each attack it from different ends (A/Z) or we split each entry between us - you bung in the blurb and I take care of the trimmings.

What do you think?
Comments wanted:
Missing OXPs? What do you think is missing?
Lore: The economics of ship building How many built for Aronar?
Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
User avatar
maik
Wiki Wizard
Wiki Wizard
Posts: 2028
Joined: Wed Mar 10, 2010 12:30 pm
Location: Ljubljana, Slovenia (mainly industrial, feudal, TL12)

Re: Oolite Wiki

Post by maik »

Cholmondely wrote: Mon Apr 05, 2021 8:12 am
Updating the wiki
Do I understand your intention correctly, you want to copy the extension manager descriptions to the wiki?
User avatar
Cholmondely
Archivist
Archivist
Posts: 5405
Joined: Tue Jul 07, 2020 11:00 am
Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
Contact:

Re: Oolite Wiki

Post by Cholmondely »

maik wrote: Mon Apr 05, 2021 11:20 am
Cholmondely wrote: Mon Apr 05, 2021 8:12 am
Updating the wiki
Do I understand your intention correctly, you want to copy the extension manager descriptions to the wiki?
Hiran has suggested that (in collaboration with myself and anybody else who wishes to join in) we create new wiki pages for the OXZs on the Expansions Manager which have no such page.

So far I've not had to refer to the 'i' descriptions on the Expansions Manager, but it is a source of information where all else fails.

Unlike me, he is a practitioner of the Dark Arts.
Comments wanted:
Missing OXPs? What do you think is missing?
Lore: The economics of ship building How many built for Aronar?
Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
User avatar
maik
Wiki Wizard
Wiki Wizard
Posts: 2028
Joined: Wed Mar 10, 2010 12:30 pm
Location: Ljubljana, Slovenia (mainly industrial, feudal, TL12)

Re: Oolite Wiki

Post by maik »

Cholmondely wrote: Mon Apr 05, 2021 11:42 am
maik wrote: Mon Apr 05, 2021 11:20 am
Cholmondely wrote: Mon Apr 05, 2021 8:12 am
Updating the wiki
Do I understand your intention correctly, you want to copy the extension manager descriptions to the wiki?
Hiran has suggested that (in collaboration with myself and anybody else who wishes to join in) we create new wiki pages for the OXZs on the Expansions Manager which have no such page.

So far I've not had to refer to the 'i' descriptions on the Expansions Manager, but it is a source of information where all else fails.

Unlike me, he is a practitioner of the Dark Arts.
I wonder how we could automate this. Long-term it is a pain to maintain things twice, and thus will not happen consistently (e.g. if an OXZ author updates the description for the extension manager the copy on the wiki would need an update, too). Couldn't we have one source for this data only, and have both generated from this?
User avatar
montana05
---- E L I T E ----
---- E L I T E ----
Posts: 1166
Joined: Mon May 30, 2016 3:54 am
Location: lurking in The Devils Triangle (G1)

Re: Oolite Wiki

Post by montana05 »

Cholmondely wrote: Mon Apr 05, 2021 11:42 am
Hiran has suggested that (in collaboration with myself and anybody else who wishes to join in) we create new wiki pages for the OXZs on the Expansions Manager which have no such page.

So far I've not had to refer to the 'i' descriptions on the Expansions Manager, but it is a source of information where all else fails.

Unlike me, he is a practitioner of the Dark Arts.
I will be happy to assist, but I do agree with Malik, creating new pages for OXZ's missing them is great, as soon as you create new categories it would be advisable to add scripts for automation. Unfortunately now we already have a lot of pages from the past hardy to get updated.
Scars remind us where we've been. They don't have to dictate where we're going.
User avatar
hiran
Theorethicist
Posts: 2415
Joined: Fri Mar 26, 2021 1:39 pm
Location: a parallel world I created for myself. Some call it a singularity...

Re: Oolite Wiki

Post by hiran »

maik wrote: Mon Apr 05, 2021 11:50 am
I wonder how we could automate this. Long-term it is a pain to maintain things twice, and thus will not happen consistently (e.g. if an OXZ author updates the description for the extension manager the copy on the wiki would need an update, too). Couldn't we have one source for this data only, and have both generated from this?
I thought of something like automatically generating wiki pages from expansions. This could be a small batch job that runs at regular intervals or maybe as part of the CI/CD pipeline.
  • From that list it uses the download links, then downloads and scans the OXPs, OXzs and whatever it can get hold of. Not sure here, currently I think reading the manifest could be sufficient, future versions could access more information.
  • From this information we could then generate wiki pages, one or several if need be. Or filterable/sortable ones if that is possible.
  • Finally these pages get uploaded into the oolite wiki.
Not that hard to code. It would more require some knowledge about the expansions and the source to read and the destination to write.
Last edited by hiran on Mon Apr 05, 2021 6:04 pm, edited 1 time in total.
Sunshine - Moonlight - Good Times - Oolite
User avatar
hiran
Theorethicist
Posts: 2415
Joined: Fri Mar 26, 2021 1:39 pm
Location: a parallel world I created for myself. Some call it a singularity...

Re: Oolite Wiki

Post by hiran »

Thinking about this, it could be a very similar process to document ships.
And enemies.
And planets.
And...

The real benefit comes where the data is available in the wiki plus in the in-game information. Alternatively the game could just open a browser window for further reference - I find it a bit annoying to read long text in the limited text rendering capabilities of oolite.

Understand me right: I do not expect the text rendering of oolite to be improved. But let's use the wiki where it is strong and oolite for the game itself.
Last edited by hiran on Mon Apr 05, 2021 6:05 pm, edited 1 time in total.
Sunshine - Moonlight - Good Times - Oolite
User avatar
Cholmondely
Archivist
Archivist
Posts: 5405
Joined: Tue Jul 07, 2020 11:00 am
Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
Contact:

Re: Oolite Wiki

Post by Cholmondely »

Does Extension = Expansion = (OXZs & OXPs) ?
Comments wanted:
Missing OXPs? What do you think is missing?
Lore: The economics of ship building How many built for Aronar?
Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
User avatar
Cody
Sharp Shooter Spam Assassin
Sharp Shooter Spam Assassin
Posts: 16081
Joined: Sat Jul 04, 2009 9:31 pm
Location: The Lizard's Claw
Contact:

Re: Oolite Wiki

Post by Cody »

<nods sagely>
I would advise stilts for the quagmires, and camels for the snowy hills
And any survivors, their debts I will certainly pay. There's always a way!
User avatar
hiran
Theorethicist
Posts: 2415
Joined: Fri Mar 26, 2021 1:39 pm
Location: a parallel world I created for myself. Some call it a singularity...

Re: Oolite Wiki

Post by hiran »

Cholmondely wrote: Mon Apr 05, 2021 3:18 pm
Does Extension = Expansion = (OXZs & OXPs) ?
I may be using the wrong words. Please forgive me... :oops:
Some domains call it extension, some expansion, some plugins, some addons, some ....
I was talking about the OXZs and OXPs.
Sunshine - Moonlight - Good Times - Oolite
User avatar
maik
Wiki Wizard
Wiki Wizard
Posts: 2028
Joined: Wed Mar 10, 2010 12:30 pm
Location: Ljubljana, Slovenia (mainly industrial, feudal, TL12)

Re: Oolite Wiki

Post by maik »

hiran wrote: Mon Apr 05, 2021 2:11 pm
maik wrote: Mon Apr 05, 2021 11:50 am
I wonder how we could automate this. Long-term it is a pain to maintain things twice, and thus will not happen consistently (e.g. if an OXZ author updates the description for the extension manager the copy on the wiki would need an update, too). Couldn't we have one source for this data only, and have both generated from this?
I thought of something like automatically generating wiki pages from expansions. This could be a small batch job that runs at regular intervals or maybe as part of the CI/CD pipeline.
  • From that list it uses the download links, then downloads and scans the OXPs, OXzs and whatever it can get hold of. Not sure here, currently I think reading the manifest could be sufficient, future versions could access more information.
  • From this information we could then generate wiki pages, one or several if need be. Or filterable/sortable ones if that is possible.
  • Finally these pages get uploaded into the oolite wiki.
Not that hard to code. It would more require some knowledge about the expansions and the source to read and the destination to write.
I agree the initial creation of wiki pages from manifests is not that hard to code, you just need a unique identifier across manifests and the wiki to not start creating duplicates.

The more difficult bit comes when there are updates. One author might leave the manifest as is and just update the wiki page, another might update the manifest but does not like editing the wiki, and the third one is happy to keep both in sync :)

I believe we should have a complete strategy before we implement such automation. The risk to mess up the wiki is quite real :?

I can see if I can create a wiki playground again for testing when we get somewhat further.
User avatar
hiran
Theorethicist
Posts: 2415
Joined: Fri Mar 26, 2021 1:39 pm
Location: a parallel world I created for myself. Some call it a singularity...

Re: Oolite Wiki

Post by hiran »

maik wrote: Mon Apr 05, 2021 7:24 pm
I agree the initial creation of wiki pages from manifests is not that hard to code, you just need a unique identifier across manifests and the wiki to not start creating duplicates.

The more difficult bit comes when there are updates. One author might leave the manifest as is and just update the wiki page, another might update the manifest but does not like editing the wiki, and the third one is happy to keep both in sync :)

I believe we should have a complete strategy before we implement such automation. The risk to mess up the wiki is quite real :?
For updates you mention different cases:
  • Automatically generated pages: This is trivial as for updates we can simply overwrite the page.
  • Some authors just update the wiki page: We could track for manual changes and no longer auto-update the page - but this behaviour would mean once touched it is back in manual mode, and the quality would deteriorate. Therefore I propose to discourage manually updating pages that were generated or even protect them from interactive users.
  • Those that update the manifest only are the good boys, and the first rule applies.
  • A bit stranger is if users keep both manifest and wiki page up to date. This is the only case where I see a strategy is necessary. But once we have the automation ready a goal should be set to synchronize the data on the manually maintained wiki pages into the OXPs so we have one source of truth. OXP maintainers should actually agree as from then on they only would have to care about their OXP and the inclusion in the OXP list but nothing else. it eases their life.
maik wrote: Mon Apr 05, 2021 7:24 pm
I can see if I can create a wiki playground again for testing when we get somewhat further.
This is actually the best approach to move on.
Sunshine - Moonlight - Good Times - Oolite
User avatar
hiran
Theorethicist
Posts: 2415
Joined: Fri Mar 26, 2021 1:39 pm
Location: a parallel world I created for myself. Some call it a singularity...

Re: Oolite Wiki

Post by hiran »

In the meantime I could give that batch job a try.
Who knows which download URL is used by the Expansion Manager to get the most up to date list of plugins?

I found this line so far:
https://github.com/OoliteProject/oolite ... ager.m#L48

which indicates to me this would be the URL used by oolite to find expansions:
http://addons.oolite.org/api/1.0/overview

Next is to figure out syntax and grammar of the data. Or the best parser to choose, as I'd prefer to not implement that myself.
However I am not familiar with Objective C, yet it seems the data format is whatever is generated using the NSCoding protocol.
Sunshine - Moonlight - Good Times - Oolite
Post Reply