Ask Your Question
0

Is there a procedure for removing obsolete documentation?

asked 2017-07-09 10:15:34 -0500

damjan gravatar image

As a specific example, this tutorial is heavily outdated (still referring to rosbuild and using roslib.load_manifest) and seems to be superseeded by this and this tutorial. Is there any procedure for removing the obsolete tutorial (as it is likely to confuse newcomers)?

edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted
1

answered 2017-07-09 11:11:07 -0500

gvdhoorn gravatar image

No, I don't think there is a standardised procedure. As it's a wiki, pages are either updated or removed.

In this case, I would recommend to update the page by using the Buildsystem(..) macro.

That should make it possible to provide proper instructions for both rosbuild and Catkin`.

edit flag offensive delete link more

Comments

I'm actually be in favor of removing it completely, as I think it duplicates information better presented here and here

damjan gravatar imagedamjan ( 2017-07-10 03:36:27 -0500 )edit

Those two tutorials do seem to cover about the same content, yes. They do separate things into two tutorials, which aren't so clearly linked (well, there is the next tutorial at the top, but that might not be apparent when you get to the bottom of the page).

gvdhoorn gravatar imagegvdhoorn ( 2017-07-10 03:39:52 -0500 )edit

If after a careful inspection and comparison of those three pages you still feel that they cover the same content, then I would think deleting the old one would be acceptable.

It's a wiki, so after you've received write access, go ahead and remove the old page.

gvdhoorn gravatar imagegvdhoorn ( 2017-07-10 03:40:54 -0500 )edit

I've reviewed all three pages and I still feel the one I mention is obsolete. However, I have another concern now, which is possible links to the deleted page which will become invalidated. I've tried using the <<FullSearch(linkto:BackLinks)>> macro, but it doesn't seem to work.

damjan gravatar imagedamjan ( 2017-07-11 08:33:50 -0500 )edit
1

According to General Page Infos the only page that links to it is the dynamic_reconfigure page.

gvdhoorn gravatar imagegvdhoorn ( 2017-07-11 08:37:05 -0500 )edit

I'm unable to delete the page (can't see a "Delete" button and deleting all content and saving is disabled). Should I open up a thread on discourse.ros.org to discuss this further? I think a documented wiki page removal procedure might be a good idea.

damjan gravatar imagedamjan ( 2017-07-11 08:37:46 -0500 )edit

re: discourse: sounds like a good idea.

The answer to your question here is basically: no, there is no documented procedure. The discourse discussion could be about setting up and documenting such a procedure.

gvdhoorn gravatar imagegvdhoorn ( 2017-07-11 08:53:19 -0500 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools

1 follower

Stats

Asked: 2017-07-09 10:15:34 -0500

Seen: 53 times

Last updated: Jul 09 '17