Skip to content

A few little bugs#937

Merged
TuThoThai merged 8 commits intonextfrom
little_bugs
Sep 23, 2025
Merged

A few little bugs#937
TuThoThai merged 8 commits intonextfrom
little_bugs

Conversation

@trurlurl
Copy link
Copy Markdown
Contributor

@trurlurl trurlurl commented Jul 8, 2025

GaragePointGroup and ParkingPointGroup are never used.

@nick-knowles I changed type of Covered in DeckSpace.

@trurlurl trurlurl added this to the netex_2.0 milestone Jul 8, 2025
@trurlurl trurlurl added bug Technical mistake, inconsistency with the documentation, etc. needs documentation update The NeTEx document needs to be updated hygiene Technical dept, results in a breaking change. labels Jul 8, 2025
Aurige
Aurige previously approved these changes Jul 8, 2025
@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 8, 2025

Bugs...

Copy link
Copy Markdown
Contributor

@skinkie skinkie left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See CI, your changes require updating the examples.

@trurlurl
Copy link
Copy Markdown
Contributor Author

trurlurl commented Jul 8, 2025

See CI, your changes require updating the examples.

Yes, I know. But my GitHub configuration only checked out the xsd, so I think I can't do it in this PR - could I edit it directly on the web?

@skinkie skinkie self-assigned this Jul 9, 2025
@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 9, 2025

@Aurige you have approved a change that breaks backwards compatibility. In this case it replaces PropulsionType with PropulsionTypes. Why is this OK?

https://github.com/NeTEx-CEN/NeTEx/blob/master/xsd/netex_framework/netex_reusableComponents/netex_vehicleType_version.xsd#L208

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 9, 2025

@trurlurl consider updating this one as well

<xsd:group name="RefuellingEquipmentGroup">
        <xsd:annotation>
                <xsd:documentation>Elements for REFUELLING EQUIPMENT.</xsd:documentation>
        </xsd:annotation>
        <xsd:sequence>
                <xsd:element name="FuelType" type="FuelTypeEnumeration" minOccurs="0">
                        <xsd:annotation>
                                <xsd:documentation>The type of fuel used by a vehicle of the type.</xsd:documentation>
                        </xsd:annotation>
                </xsd:element>
        </xsd:sequence>
</xsd:group>

@Aurige
Copy link
Copy Markdown
Contributor

Aurige commented Jul 9, 2025

@Aurige you have approved a change that breaks backwards compatibility. In this case it replaces PropulsionType with PropulsionTypes. Why is this OK?

That's a mistake on my side !

@Aurige
Copy link
Copy Markdown
Contributor

Aurige commented Jul 9, 2025

By the way, I already removed ParkingPointGroup & GaragePointGroup from the documentation

@trurlurl
Copy link
Copy Markdown
Contributor Author

Shall I revert PropulsionTypes and FuelTypes? I neglected the fact that they were in v1.2.2 already and considered them as provisional and "under construction". I still don't believe that anybody really would be using them, especially given the, in my view, strange collection of FuelTypeEnums (e.g., how to interpret "electricity" vs. "battery" vs. "electricContact", or the question we had about "tpg"?).

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 10, 2025

@trurlurl the work is already done. Why would you cause more work?

@trurlurl
Copy link
Copy Markdown
Contributor Author

@trurlurl the work is already done. Why would you cause more work?

That's good news - that somehow didn't shine up at my side, thank you!

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 10, 2025

@trurlurl the question for you is do you want to change RefuellingEquipmentGroup as well?

@trurlurl
Copy link
Copy Markdown
Contributor Author

@trurlurl the question for you is do you want to change RefuellingEquipmentGroup as well?

@skinkie There isn't a list in there, so a priori no need to change. If the question is whether we'd need multiple fuel types here...? This of course depends how the fuel types are intended to be used - and my feeling is that this has possibly not been worked out yet (my previous comment about elecricity). At least it isn't cleary documented in the code and for me sort of a riddle. So I don't know what the correct answer would be. And therefore: no, I don't have the wish to change RefuellingEquipmentGroup.

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 10, 2025

It is the only place there is no list at this point. And ever regular fuel station has more than one fuel nozzle per device, so I would say updating that would also make sense.

@trurlurl
Copy link
Copy Markdown
Contributor Author

It is the only place there is no list at this point. And ever regular fuel station has more than one fuel nozzle per device, so I would say updating that would also make sense.

No objections.

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 10, 2025

@trurlurl task for you; please update the documentation :-)

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 10, 2025

@Aurige @ue71603 please review and if correct: approve

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 10, 2025

@Aurige agreed with the Refuelling Equipment upgrade too?

@Aurige
Copy link
Copy Markdown
Contributor

Aurige commented Jul 16, 2025

That's fine for me (with the deprecation) ... but we cannot update the doc any-more (sent to CEN last week)
So this PR contains changes that are already in the doc and others that aren't

@ue71603
Copy link
Copy Markdown
Contributor

ue71603 commented Jul 16, 2025

@Aurige and how should we proceed? make two PR one with documented things and one with the rest?

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Jul 16, 2025

@Aurige the issue was assigned to you prior to you sending the document to CEN.

@Aurige
Copy link
Copy Markdown
Contributor

Aurige commented Jul 16, 2025

@Aurige and how should we proceed? make two PR one with documented things and one with the rest?

I would just validate that PR and create an issue for 2.1 or 3.0 referring it as a reminder to update the doc (Ok that will be a small inconsistency, but that's unfortunately not the only one ;-) )

Copy link
Copy Markdown
Contributor

@thbar thbar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A summary of my understanding of the changes so far, with a "newcomer eye":

  • Replace PropulsionType by PropulsionTypes (N values, space-separated)
  • Replace FuelType by FuelTypes (N values, space-separated)
  • Fix typo on ProjectedFeatureRef (previously “ProjectedFeartureRef”)
  • Replace Covered possible values: from true/false to indoors (default), outdoors, or covered
  • Replace VehicleCategory by VehicleCategories
  • Replace Weight type from LengthType to WeightType
  • Remove ParkingPointGroup completely (unused)
  • Remove GaragePointGroup completely (unused)

(EDIT: maybe worth copying into the PR description if I didn't miss anything)

This one looks good to me!

@skinkie since we're aiming for NeTEx v2.0 freeze, if everything is fine we could go ahead and merge, and create a separate ticket for the CEN documentation, wdyt?

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Sep 19, 2025

No, as @Aurige mentioned this cannot continue in 2.0. Some of the changes can but not element name changes, as mentioned.

@thbar
Copy link
Copy Markdown
Contributor

thbar commented Sep 19, 2025

A try to see what could be merged (RETRO-COMPATIBLE & UNUSED), vs not (BREAKING):

  • BREAKING - Replace PropulsionType by PropulsionTypes (N values, space-separated)
  • BREAKING - Replace FuelType by FuelTypes (N values, space-separated)
  • BREAKING - Fix typo on ProjectedFeatureRef (previously “ProjectedFeartureRef”)
  • RETRO-COMPATIBLE - Replace Covered possible values: from true/false to indoors (default), outdoors, or covered
  • BREAKING - Replace VehicleCategory by VehicleCategories
  • (UNSURE)) Replace Weight type from LengthType to WeightType
  • UNUSED so OK? - Remove ParkingPointGroup completely (unused)
  • UNUSED so OK? - Remove GaragePointGroup completely (unused)

This would mean splitting the PR in 2.

@skinkie
Copy link
Copy Markdown
Contributor

skinkie commented Sep 19, 2025

In my perspective: ProjectedFeartureRef should be fixed, Same for indoor/outdoor, And the Length/WeightType. Creating plurals not part of the documentation is a no-go for me. So iff part of documentation, we can do it, otherwise no way.

If ParkingPointGroup and GaragePointGroup are not in use: we can clean that up. But as mentioned before, I rather have those things bluntly cut out in a 3.0 version.

Stefan

@Aurige
Copy link
Copy Markdown
Contributor

Aurige commented Sep 19, 2025

as said before that's fine for me (with the deprecation) ... but we cannot update the doc any-more (sent to CEN last week)
So this PR contains changes that are already in the doc and others that aren't, we need to keep track of further doc update needed.
Since we have a meeting next week, I would rather validate the decision with the group and the merge (or not if we get a "no" which is unlikely)

@ue71603
Copy link
Copy Markdown
Contributor

ue71603 commented Sep 21, 2025

We probably should:

  • Finalise a 2.0.0 (based on the version sent to the secretariat)
  • Start adding the new things to a 2.0.1 version.
  • Label all issues with feature/ or bug/ depending on what they are. A 2.0.1 can only contain bugs
  • This also means we have now two active branches one for 2.1/3.0 (the next) and a bugfix branch for 2.0.0
  • This means: carefully thinking about adding what to what.
  • Also the document changes needed in future should be clearly documented in the isue or we have a 2.0.1 version ready to add those.
    Perhaps to discuss on Tuesday.

@TuThoThai TuThoThai merged commit f748539 into next Sep 23, 2025
1 check passed
@TuThoThai TuThoThai deleted the little_bugs branch September 23, 2025 15:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Technical mistake, inconsistency with the documentation, etc. hygiene Technical dept, results in a breaking change. needs documentation update The NeTEx document needs to be updated

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants