54 Matching Annotations
  1. Nov 2024
    1. TRSP Desirable Characteristics PID services and PID Managers SHOULD have clear versioning policies.

    1. TRSP Desirable Characteristics

      Mechanism and process to make and track edits to a dataset after deposition: does the repository enable modification to the submitted dataset (e.g., to correct it or append additional information)? Is there a process to distinguish, link and access all versions of the data?

    1. TRSP Desirable Characteristics

      The repository approach to changing and versioning data and metadata. How the approach and records of changes are communicated to data depositors and users.

  2. Aug 2024
    1. A change in the minor component signifies a non-breaking change, and that the consumer can safely use the new version without breaking, although the consumer might need to be updated to use its new functionality. For example, adding a non-mandatory feature column with a default value to the model is a minor bump, because when a value for the added column is not passed, inference still works.
    2. Using semantic versioning facilitates model deployment, by communicating which if a new version can be deployed without changes to the application:
  3. May 2024
    1. All API endpoints within the specification are versioned individually. This means that /v3/sync (for example) can get deprecated in favour of /v4/sync without affecting /v3/profile at all. A server supporting /v4/sync would keep serving /v3/profile as it always has

      It's cool, I guess. But then leaves one wonder, are they compatible? How to tell? There should be a kind of manifest then that maps v4 to "playing well together" granular vs.

  4. Jan 2024
  5. Dec 2023
    1. 巢狀結構,可以建立多層筆記本分類(雖然這樣做不一定比較好)一則筆記可以放入多個筆記本!

      一放入多:最好是採用連結,以免生出內容稍有出入的多個版本,那就罪大惡極。

      後記 Update: I tested it and confirm the note is referred to by link. So, changing the note will update it for all notebooks the note is under. 經我測試,確認是一份筆記內容,多個連結。

    2. 不過 UpNote 的版本備份預設不是無限的(可以手動修改),預設會記錄最近的 50 個版本。

      50個版本也太佛心

  6. Nov 2023
  7. Oct 2023
    1. When content underlying a DOI is updated, we recommend updating the DOI metadata and, for major changes, assigning a new DOI. For minor content changes, the same DOI may be used with updated metadata. A new DOI is not required. For major content changes, we recommend assigning a new DOI and linking the new DOI to the previous DOI with related identifiers.

      Characteristics

  8. Sep 2023
  9. Jul 2023
  10. Apr 2023
  11. Mar 2023
    1. Unable to see a previous version of your file? The revisions for your file may occasionally be merged to save storage space. Note: If you don't have permission to edit a file, you won't be able to see the version history.

      In other words, Google Docs can't be relied on for versioning.

  12. Jan 2023
  13. Dec 2022
  14. Oct 2022
    1. If the common storage type has to be changed (for example from string to int), a migration of content is perfomed together with any necessary update of the mapping code
    1. With a well-defined versioning strategy, when releasing a non-backwards compatible version, you can keep the existing one and the new one working in parallel for a pre-defined window of time
    1. you will need to accommodate backwards compatibility or support multiple versions of an API running in parallel
  15. Aug 2022
  16. Apr 2022
  17. Mar 2022
  18. Jan 2022
    1. The key thing about the REST approach is that the server addresses the client state transitions. The state of the client is almost totally driven by the server and, for this reason, discussions on API versioning make little sense, too. All that a client should know about a RESTful interface should be the entry point. The rest should come from the interpretation of server responses.
  19. Sep 2021
    1. My understanding is that the caret is the answer for traditional SemVer, i.e., there will be breaking changes prior to 0.1.0, there may be breaking changes between minor versions prior to 1.0.0, and there may only be breaking changes between major versions above 1.0.0.
  20. Aug 2021
    1. The TypeScript team has made it clear. They do not follow semver. "minor" (X.X) releases can contain breaking changes. Major releases (X) have very little meaning.
  21. Dec 2020
  22. Nov 2020
    1. Adapters are strictly versioned: any change to an adapter interface - associative or not - is considered breaking and will cause a major version update of the component.
    1. I feel that with all that power that it’s gaining, instead of being a more approachable tool, that it’s actually being a tool that is continuously making people feel frustrated, to the point where I feel that whatever the next version control system is… (And it does not have to be something separate than Git. It should maybe be just a really powerful abstraction built on top of Git.) But I think whatever the next iteration of the people’s version control is… it should be something that is more reflective of how we think about what version control is for us.
  23. Oct 2020
  24. Sep 2020
    1. The versions must be compatible, so if a peerDependency is listed as 2.x, you can’t install 1.x or another version. It all follows semantic versioning.
  25. Apr 2020
  26. Jan 2020
  27. Nov 2018
  28. Jun 2018
    1. Barbary K. 2014 sncosmo Zenodo, 10.5281/zenodo.11938

      This software citation losts its version information. We will have to work on our typsetting and production rules, as well as develop formal JATS/NLM XML schema to contain versioning information.

  29. Oct 2017
  30. May 2015
    1. I'm a big fan of the approach that Stripe has taken to API versioning -

      Ouch ! :/ I read somewhere else that this was in fact very bad practice...