Schedule2

[saerdnaer]

breaking changes to the schedule.json schema, thereby a own new version called schedule2, see 6632bbb for an comparison between the formats

• some unused fields get dropped, e.g. public_name, daysCount, timeslot_duration, …
• Track: color -> colors to allow multiple color values e.g. for light an dark – and to be uniform to same attribute on Conference
• Track: gets a guid field
• translations of abstract, description etc. get switched from Accept header "string" to object {"en": "string", "de": "string"}, but the old way is still allowed
• Day: day_start and day_end get's unified to start and end
• events and persons get it's own top level field, and are no longer nested
  • but events still have to be sorted by date and room.order as before by the schedule generator/serializer
  • connection from Event to Person is named Participant and has a role attribute
• Images like logo and avatar are now an object {"url": "uri-string"} instead of "uri-string"
• Event has now start and end instead of date and duration, fixing Clarify duration spec #129

TODOs

• decide how the references on Event to room should look like
• decide how the references on Event to track should look like
• decide if Participant.role should be an enum
• add Reference.service enum based on ucdata
• add languages: ['en', 'de'] on Conference
• add defaults: { theme: 'dark', language: 'en' }… on Conference?

[saerdnaer]

@toto Sollen wir die kompletten Services hierher in schedule2 mit übernehmen?

https://github.com/toto/conference-import/blob/e51e5a35788a6735a724ece59e84018efd18dc41/src/models/link.ts#L1-L8

service: "web" | "twitter" | "facebook" | "github" | "youtube" | "vimeo" | "mastodon" | "bluesky" | "threads" | "vimeo" | "livevoice" | "activityPub"

[toto]

Not all pick: that's historical baggage. How about

• Video: YouTube, Vimeo
• Social: Facebook, ActivityPub, LinkedIn, GitHub and threads.
  Plus "web" as the default.

[Kunsi]

If we're defining multiple colours, we should add a field for preferred colour scheme so apps know which to select in case there's no user choice.

[Kunsi]

An additional question would be if it really makes sense to have different colours for light and dark mode here, if the Conference only defines a primary and background colour.

[johnjohndoe]

Not sure if a preferred color scheme property is needed. Mobile apps typically follow either the system settings or provide a way for users to customize the scheme within the app as show in the screenshot:

[Kunsi]

Keep in mind we don't always have that. For example, pretalx always uses light mode as of now, so that would be preferred. info-beamer in itself does also not know what the user preference is, so it would use the organizer preferences.

[johnjohndoe]

Thank you for the clarification. @saerdnaer It would be great to provide some context in the issue description up there and list all the clients which consume the JSON.

[Kunsi]

I don't believe we have a list of all the apps that might consume the json schedule.

[johnjohndoe]

It does not have to be complete to be valuable.

[johnjohndoe]

Should we rename language to languages? It is not limited to one language if I remember correctly.

[Kunsi]

Depends if we want to include the languages of possible translations. If this is the language of the talk itself, there can only ever be one i think.

[johnjohndoe]

I believe talks can still be hold in multiple languages, e.g. where speaker1 talks English and speaker2 talks German.

[toto]

Let’s have one language the talk is held in. If we want translations that should be a different field / indicated in some way.

[johnjohndoe]

I did not refer to translations here. I really meant a talk which is hold in different languages and is therefore announced as such, e.g. en, de.

[rixx]

Is there any system that currently supports this? AFAIK neither frab nor pretalx do; pretalx certainly assumes that a talk is in one language.

[johnjohndoe]

I remember seeing it in the Android app at one point. I would need to investigate to find out what the source backend was.

[johnjohndoe]

I could be that session with multiple languages originate from a wiki import at 38C3.

[saerdnaer]

for self-organized sessions created in the Hub, there is the option to select a ordered list of possible languages, via a dropdown with the options en, de, en, de, de, en.

In general I would see this field as main/original language and add an additional translations field and does not really like to force everybody to an array, only for the rare edge case that multiple languages are use in the same talk e.g. with multiple sections/speakers. That would be an complete other feature similar to chapters in a podcast episode.

[johnjohndoe]

What does the UI for SOS look like / tell about the language selection? Are they being selected as the speakers languages or as the available translations?

[saerdnaer]

FYI: I changed the track reference, to be uniform with the room reference

[johnjohndoe]

Are we missing a reference to the guid of the track here?

[saerdnaer]

I am not yet at the point where I see a track guid as really required, a persistent slug is a good enough "ID" for me for this kind of entity... Otherwise we have to discuss if they have the same guid across each conference instance etc.

[saerdnaer]

Hmm, should we change all enum values to UPPER_CASE?