Docs: Fix non-existent SortOrderBuilder method in evolution.md example
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 92/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Quiet
- Tech stack
- java
- Domain
- documentation
Research direction
Open docs/docs/evolution.md around line 96 and compare the replaceSortOrder example with api/src/main/java/org/apache/iceberg/SortOrderBuilder.java and NullOrder.java. Verify the corrected example against the API, then confirm the code block no longer contains the reported compilation errors.
Written by the indexing model from the issue text.
Description
Apache Iceberg version
main @ 49b89a8c5
Query engine
None (Java API)
Please describe the bug
The replaceSortOrder example in docs/docs/evolution.md (line 96) calls .dec("category", NullOrder.NULL_FIRST). Neither exists in the API: SortOrderBuilder (api/src/main/java/org/apache/iceberg/SortOrderBuilder.java) only defines desc(...), not dec(...), and NullOrder (api/src/main/java/org/apache/iceberg/NullOrder.java line 22-23) only defines the constants NULLS_FIRST/NULLS_LAST, not NULL_FIRST. The example does not compile as written. The line directly above it (.asc("id", NullOrder.NULLS_LAST)) already uses the correct constant naming, so only the second line has the typo.
Steps to reproduce
Copy the example code block from docs/docs/evolution.md line 93-97 into a Java file and compile it: fails with "cannot find symbol" for both dec and NULL_FIRST.
Additional context
N/A.
- Dominant language
- Java
- Stars
- 9.3k
- Forks
- 3.5k
- Avg merge
- 2d 11h
- Merged PRs (30d)
- 143
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from apache/iceberg
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
improvement
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
infinispan/infinispan#18150 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
opensearch-project/k-NN#3597 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100