Manual TODOs referring to very outdated Blender versions #75608

New Issue

Wouter Stomp · 2020-04-11T11:00:07+02:00

Wouter Stomp commented

2020-04-11 11:00:07 +02:00

Throughout the manual there are many TODO's in the text, many of which refer to very old versions of Blender. Although having a TODO there clearly serves a function, having an old version number looks weird and I don't think it serves any function.

Examples:
2.62: https://docs.blender.org/manual/en/dev/physics/dynamic_paint/brush.html?highlight=todo
2.76: https://docs.blender.org/manual/en/dev/animation/armatures/bones/editing/delete.html?highlight=todo

Searching the manual for TODO shows up quite a few more. Can these version numbers be removed?

Throughout the manual there are many TODO's in the text, many of which refer to very old versions of Blender. Although having a TODO there clearly serves a function, having an old version number looks weird and I don't think it serves any function. Examples: 2.62: https://docs.blender.org/manual/en/dev/physics/dynamic_paint/brush.html?highlight=todo 2.76: https://docs.blender.org/manual/en/dev/animation/armatures/bones/editing/delete.html?highlight=todo Searching the manual for TODO shows up quite a few more. Can these version numbers be removed?

Wouter Stomp commented

2020-04-11 11:00:07 +02:00

Added subscriber: @blenderrocket

blender-admin commented

2020-04-11 11:00:07 +02:00

#83121 was marked as duplicate of this issue

Aaron Carlisle commented

2020-04-11 12:38:04 +02:00

Added subscriber: @Blendify

Aaron Carlisle commented

2020-04-11 12:38:04 +02:00

These help people that would want to fill them in know about which version the feature was added. This helps them look into the release notes to possibly find an explanation of the feature.

Wouter Stomp commented

2020-04-11 13:00:59 +02:00

Maybe they can be hidden in html? Or if left in place make it something like TODO (feature added in 2.62)?

Jamie Chaisson commented

2020-04-21 04:21:27 +02:00

Added subscriber: @jamjchai

Jamie Chaisson commented

2020-04-21 04:21:27 +02:00

I would like to find out more about how I may help with this task. I am new to contributing but have dabbled with blender since 2.50.

Aaron Carlisle commented

2020-04-23 03:57:15 +02:00

First thing to do is to find a todo that you would like to work with. You will need some sort of text editor program such as Atom. You can then use atom to search the manual for todo 2 this will show all the todos needed to be fixed for this task.

Then you can pick one of these and fix it and submit a patch following the guide on https://docs.blender.org/manual/en/dev/about/contribute/index.html

First thing to do is to find a todo that you would like to work with. You will need some sort of text editor program such as Atom. You can then use atom to search the manual for `todo 2` this will show all the todos needed to be fixed for this task. Then you can pick one of these and fix it and submit a patch following the guide on https://docs.blender.org/manual/en/dev/about/contribute/index.html

Alaska commented

2020-11-27 21:29:57 +01:00

Added subscriber: @ToxicTuba