Update Tutorials for v3 API

[ChrisThrasher]

Description

We need to audit the new files added to pages/tutorials/3.0 in #191 for consistency with the current state of the library. This includes updating all code examples and all text discussing how these APIs work. For example a sentence that says "this function returns -1 on error" needs to be changed to reflect that the API now returns std::nullopt upon error. The latter is probably going to be the more tedious thing to update. In some places we will need to add new text to discuss new features.

This issue will track the state of each file. I ask that anyone working on this fix one or more files in their entirety so that no file is left in a partially edited state. A given PR may update multiple files. Just be sure to link to that PR in this issue. Please speak up and claim a given file you wish to update so that no two people rewrite the same file.

If we want to add new documentation files or remove some then that ought to be discussed as well. If a file is going to be removed it would be nice to remove it before we do the work to update it.

Style Changes

I wish to make one style change while we're touching these files. migration.md was written such that each sentence is its own line of Markdown code. This is contrast to the current state of these Markdown files where an entire paragraph of text is one line of code. This is cumbersome because changing a single character results in a diff where the entire paragraph is marked as changed. One sentence per line is a simple fix to that problem.

Files

• index.md (No changes required)

Getting Started #198

• getting-started/code-blocks.md
• getting-started/linux.md
• getting-started/macos.md
• getting-started/compile-with-cmake.md
• getting-started/visual-studio.md
• getting-started/cmake.md

System

• system/stream.md Update stream.md #200
• system/time.md Update time.md for SFML 3 #195

Window

• window/events.md Update events.md #202
• window/inputs.md Update inputs.md #203
• window/opengl.md Update opengl.md #204
• window/window.md Update window.md #205

Graphics

• graphics/draw.md Update draw.md #206
• graphics/shader.md Update shader.md #207
• graphics/shape.md Update shape.md #208
• graphics/sprite.md Update sprite.md #209
• graphics/text.md Update text.md #210
• graphics/transform.md Update transform.md #211
• graphics/vertex-array.md Update vertex-array.md #213
• graphics/view.md Update view.md #214

Network

• network/ftp.md Update ftp.md #215
• network/http.md Update http.md #216
• network/packet.md Update packet.md #217
• network/socket.md Update socket.md #218

Audio

• audio/recording.md Update recording.md #219
• audio/sounds.md Update sounds.md #220
• audio/spatialization.md Update spatialization.md #222
• audio/streams.md Update streams.md #223