Repository navigation
fix: content errors on the Machine actionability page - #1893
Merged
bianchini88 merged 11 commits intoOct 30, 2026
Merged
Conversation
- Reword the formats to avoid: the issue is unstructured text and images without embedded metadata, not the .txt/.tiff extension (ISA-TAB, MAGE-TAB and OME-TIFF are recommended later on the page). - Describe XML as nested elements with attributes rather than key-value pairs. - Replace "web browsers understand RDF" with search engines, harvesters and linked-data applications. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
Before approving and merging a pull request (PR), the editors must check that
Please refer to the complete editor's checklist for details. |
This change improves the documentation by refactoring prose for clarity, standardizing link text and references to the metadata management page, updating outdated URLs to W3C and other resources, and removing redundant explanations. The edits maintain technical accuracy while enhancing readability and reducing verbosity throughout the page.
Reorganize the explanation to emphasize that human readability and machine-actionability are separate properties. Simplify the initial definition with a concrete example (scanned documents), then introduce CSV and PDF as contrasting examples before diving into the detailed quote from Open Data Handbook.
Replace "element" with "content" in XML tag example for accuracy, change "is" to "can be" for machine-interpretability statement, update taxonomy URL to current identifier format, and fix URL encoding in fairsharing link.
Replace space encoding in query parameter from %20 to %2520 to properly handle the URL-encoded subject filter in the fairsharing search link.
Standardize punctuation, replace modal verbs for consistency, and improve phrasing throughout the document. Changes include: adding missing period after PDF format description, replacing "Could" with "Can", simplifying negation phrasing in metadata checklist definition, removing question mark from query example, adjusting article usage before acronyms, and converting DOI reference to markdown link format.
Update file format examples to include CSV. Remove redundant text from schema description. Replace bare ENA reference with tool link and checklist URL. Add direct links to EFO and OBI ontologies.
toniher
marked this pull request as ready for review
October 5, 2026 20:39
Contributor
Author
|
@bianchini88 finished work from last week's F2F meeting |
Minor grammar and style
Adding myself as an editor for this page
bianchini88
approved these changes
Oct 30, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This addresses #1887