The Standard Library Documentation Checklist

[steveklabnik]

I've been doing work on random parts of the standard library, but it's time to get systematic.

Here's a list of all of the top-level modules in std, with separate tracking issues for each part. Documentation is never done, but I'd at least like to ensure that every module is seen at least once.

PRs will be sent for consistency, more examples, better explanations, all the usual stuff. But here's how we can track progress.

One specific area where we can do much better is linking of types to their docs in text explanations.

• home page #29330
• array #29331
• bool #29332
• char #29333
• floats #29334
• integers #29335
• raw pointers #29336
• slices #29337
• str #29338
• tuples #29339
• any #29340
• borrow #29342
• boxed #29343
• cell #29344
• char #29345
• clone #29346
• cmp #29347
• collections #29348
• convert #29349
• default #29350
• env #29351
• error #29352
• std::float #29353
• ffi #29354
• fmt #29355
• fs #29356
• hash #29357
• std::integer #29358
• io #29359
• iter #29360
• marker #29361
• mem #29362
• net #29363
• num #29364
• ops #29365
• option #29366
• os #29367
• prelude #29369
• process #29370
• ptr #29371
• rc #29372
• result #29373
• std::slice #29374
• std::str #29375
• string #29376
• sync #29377
• thread #29378
• time #29379
• vec #29380
• macros #29381
• std::char #29428

[matthew-piziak]

@steveklabnik Looks like io, num, std::slice, and vec are closed and can be checked off.

[critiqjo]

Suggestion: Turn this into a Project? (Might help in gaining visibility, or just to test if the workflow helps?)

[matthew-piziak]

@critiqjo I like that idea! Is anybody against it? I would put one up but it seems that project creation is restricted.

[GuillaumeGomez]

I think I went over every items. Once I have time, I'll try to check if I missed any.

[steveklabnik]

We haven't, as a matter of project policy, decided if we're using projects, and for what.

We should talk about it at the next docs meeting.

[frewsxcv]

Opened an issue for moving to pulldown-cmark: #38400

[steveklabnik]

Update: I'm going to go through all of the ones that are still open today and elaborate on exactly what they need to have done to be considered closed.

[lukaramu]

Update:

• env is checked off, but probably shouldn't be, as #29351 is open
• the issues for hash, net, and std::str have been closed, so these can be checked off
• path isn't listed currently (#29368)
• ascii isn't listed currently either; #29341 is still open, but can be closed, so this should probably be checked off as well
• option was already checked off somehow, but the issue is still open; as for ascii though, it has been addressed and can be closed as far as I can tell

[Mark-Simulacrum]

Unchecked env.
Checked hash, net, and std::str.

path and ascii still need to be added.

[marioidival]

@steveklabnik update checklist please:
convert, done
env, done

[GuillaumeGomez]

Updated.

[steveklabnik]

I think this issue has served its use. There's only a few things left, and we can track them in their own issues.

Thank you to everyone who pitched in and made the standard library docs better over the last three years! ❤️