René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Feature: Add Bookmark","articleBody":"As multiple issues have stated before, it would be great if we the captions supported in python-docx.  Previous issues already should temporary fixes to similar problems like the IndexedEntry (#137) and the figure caption in (#359). \r\nAlso bookmarks have been investigated: (#109)\r\nAs I understood from: [feature analysis: section columns](#355) and [Feature: Paragraph.add_hyperlink() (wip)](#278)\r\nIs that there are a few mandatory steps to take before a pull request is accepted:\r\n\r\n- Feature analysis:\r\n  1. XML schema analysis\r\n  2. Candidate API (preferably based on the [VBA API](https://msdn.microsoft.com/VBA/Word-VBA/articles/object-model-word-vba-reference) \r\n  3. Specimen XML \r\n- Tests:\r\n  1. Acceptance Test\r\n  2. Unittests\r\n\r\nFinally: **Focus** is key, one feature should only by a single functionality, to quote @scanny:\r\n\r\n\u003e - No code gets merged without its corresponding unit test.\r\n\u003e- No unit test gets written without a failing acceptance test.\r\n\u003e- Each commit is one atomic piece of functionality, generally a single property or method. \r\n\r\nNow I've collected the available issues and pull request my question is, how to go from here. I would assume that we start at the beginning: **Feature analysis**\r\n\r\nAdding the caption to a paragraph isn't directly the issue, the main goal is to create a feature which can be used together with a crossreference. Therefore the number of references or bookmarks that are created should be stored in an object.  This object should be available to the caption method, in order to be support a sort of 'guessed figure/table number'. What I mean by this is best explained with an example:\r\n\r\nThe proposed solution in #359 works. Only he user first has to create a print view to force a fieldcode refresh to make the numbers visible. Therefore, it would be nice if the caption method could already place a \"guessed\" number. (Comparable as how Word behaves)\r\n\r\n\r\n\r\n","author":{"url":"https://github.com/Benjamin-T","@type":"Person","name":"Benjamin-T"},"datePublished":"2017-08-17T17:58:42.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":35},"url":"https://github.com/425/python-docx/issues/425"}