[libcxx-commits] [PATCH] D108502: [libc++][doc] Cleanup, normalize, and update projects status docs

Christopher Di Bella via Phabricator via libcxx-commits libcxx-commits at lists.llvm.org
Sat Aug 21 17:40:18 PDT 2021


cjdb requested changes to this revision.
cjdb added a subscriber: zoecarver.
cjdb added a comment.
This revision now requires changes to proceed.

I'm with @mordante on splitting this up into two patches, but I can see why you've combined them.



================
Comment at: libcxx/docs/Status/FormatPaper.csv:9
 [format.arg],"Class template basic_format_arg",,Mark de Wever,`D103357 <https://llvm.org/D103357>`__,Review,
-[format.arg],"Class template basic_format_arg - handle",,,,,,
-[format.arg],"Class template basic_format_arg - pointers",,,,,,
+[format.arg],"Class template basic_format_arg - handle",,,,,
+[format.arg],"Class template basic_format_arg - pointers",,,,,
----------------
It'd be great if you could inject `Not started` and `Unassigned` into everything that's blank.


================
Comment at: libcxx/docs/Status/RangesPaper.csv:2
 Section,Description,Dependencies,Assignee,Complete
-[tuple.helper],Update <tuple> includes.,None,Unassigned,Not started
+[tuple.helper],Update <tuple> includes.,None,Unassigned,|Not Started|
 `[range.cmp] <http://wg21.link/range.cmp>`_,"| `ranges::equal_to <https://llvm.org/D100429>`_
----------------
Please leave this as `Sentence case` (similarly elsewhere).

Alternatively: abandon all changes to this file, as it'll probably get deleted once P0896 is fully implemented. This doc exists mainly to help @zoecarver, @ldionne, and me coordinate who's doing what, and I'm okay with it being a bit different.


================
Comment at: libcxx/docs/Status/RangesPaper.csv:8
 | `ranges::less_equal <https://llvm.org/D100429>`_
-| `ranges::greater_equal <https://llvm.org/D100429>`_",None,Zoe Carver,✅
+| `ranges::greater_equal <https://llvm.org/D100429>`_",None,Zoe Carver,|Complete|
 `[readable.traits] <http://wg21.link/readable.traits>`_,"| `indirectly_readable_traits <https://llvm.org/D99461>`_
----------------
mumbleskates wrote:
> Mordante wrote:
> > Why change this? I'm not working on Ranges so don't have a strong opinion. But I assume the authors picked the checkmark since they prefer it that way.
> Accessibility; consistency; ability to enter it in without hunting down another check mark and copy-pasting it.
> 
> Assuming we want to keep the check marks for some reason it's better to create an entry in Styles.rst like `.. |checkmark| unicode:: U+2705` and use that.
> 
> This is mostly cjdb's domain, I'll leave it up to him whether he prefers text or a check mark.
No strong preference, as copy/pasting a checkmark is pretty trivial now that it's being used in this file.
As for why we chose checkmarks? No clue. Possibly to make it visually distinct from text-based `Not started` and `In progress`, which arguably does have a benefit.


Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D108502/new/

https://reviews.llvm.org/D108502



More information about the libcxx-commits mailing list