Content update by merging of markup language documents

Inventors

Kostakis, Georgios

Assignees

Bentley Systems Inc

Interested in licensing this patent?

MTEC can help explore whether this patent might be available for licensing for your application.

Publication Number

US-12248749-B1

Patent

Publication Date

2025-03-11

Expiration Date


Abstract

In various example embodiments, techniques are provided for updating content of a markup language document. A software process receives a markup language document having one or more sections and a corresponding enhancement document that includes a plurality of commands describing updates to the markup language document. The software process converts the markup language document into a first hierarchical graph in which each section of the markup language document is arranged as a parent of any subsections of the respective section. The software process also converts the enhancement document into a second hierarchical graph including one or more of the commands. The software process merges the first hierarchical graph and the second hierarchical graph, the merging to apply commands of the second hierarchical graph to the first hierarchical graph to produce an updated hierarchical graph. The software process then outputs an updated markup language document based on the updated hierarchical graph.

Core Innovation

The invention provides a markup language merge software process for updating content of a markup language document. The process receives the markup language document encoded with a set of symbols that instruct software how the markup language document should look when rendered on a computing device, where the markup language document includes one or more sections, and a corresponding enhancement document that includes a plurality of commands executable by software which describe updates to the markup language document.

The process converts the markup language document into a first hierarchical graph with each section arranged as a parent of any subsections of the respective section. It also converts the enhancement document into a second hierarchical graph including one or more of the plurality of commands that describe updates to the markup language document. The process then merges the first hierarchical graph and the second hierarchical graph so that the commands of the second hierarchical graph are applied to produce an updated hierarchical graph.

Based on the updated hierarchical graph, the process outputs an updated markup language document. The described update-command behavior includes appending, inserting before, implied replace, and delete, along with reference-based target selection using a reference to a section or subsection and a fallback to appending when a missing reference error occurs.

The document further describes applying the process to markup language such as Markdown for API documentation, including API definition or API code. In this context, the sections and subsections represent available endpoints, operations, input/output parameters, and authentication methods, and the enhancement document provides user-specified updates mapped to the corresponding sections or subsections in the hierarchical graph.

Claims Coverage

The document describes three independent claim sets. Across these independent claims, the core coverage is receiving a markup language document and a corresponding enhancement document of executable update commands, converting both into hierarchical graphs, merging or applying the commands to produce an updated hierarchical graph, and outputting an updated markup language document, with dependent refinements specifying hierarchical parent/subsection structure, command behaviors, and reference-based selection for target sections or subsections.

Hierarchical graph conversion and command-based merging for updating markup documents

Receiving a markup language document with one or more sections and encoded symbols that instruct software how the markup language document should look when rendered, receiving a corresponding enhancement document that includes a plurality of commands executable by software which describe updates to the markup language document, converting the markup language document into a first hierarchical graph arranging each section as a parent of any subsections, converting the enhancement document into a second hierarchical graph including one or more plurality of commands describing updates, merging the first hierarchical graph and the second hierarchical graph to apply commands of the second hierarchical graph to produce an updated hierarchical graph, and outputting an updated markup language document based on the updated hierarchical graph.

Merging hierarchical graphs to output an updated markup language document

Receiving a markup language document and a corresponding enhancement document including a plurality of commands executable by software which describe updates to the markup language document, converting the markup language document into a first hierarchical graph, converting the enhancement document into a second hierarchical graph including one or more of the plurality of commands describing updates to the markup language document, merging the first hierarchical graph and the second hierarchical graph, and outputting an updated markup language document based on a result of the merging.

Non-transitory electronic device-readable medium instructions for applying update commands via hierarchical graphs

Receiving an auto-generated markup language document and a corresponding user-content document that includes a plurality of commands describing user-specified updates to the auto-generated markup language document, converting the auto-generated markup language document into a first hierarchical graph in which each section is arranged as a parent of any subsections, converting the user-content document into a second hierarchical graph including one or more plurality of commands describing updates, applying commands of the second hierarchical graph to the first hierarchical graph to produce an updated hierarchical graph, and outputting an updated markup language document based on the updated hierarchical graph.

Collectively, the independent claims cover updating a markup language document by converting a markup document and a corresponding enhancement or user-content document of executable commands into hierarchical graphs, merging or applying the command graph to the markup graph to produce an updated hierarchical graph, and outputting an updated markup language document. The dependent claims identified in the provided claim set further specify refinements such as section/subsection parent-child structure, Markdown, auto-generated API documentation specialization, and reference-based selection and specific command operations.

Stated Advantages

Improves manual curation of large auto-generated documents (e.g., API documentation in Markdown).

Avoids repeated re-edits across rebuilds.

Documented Applications

Manual curation of large auto-generated documents such as API documentation in Markdown.

Updating API documentation generated from an API definition or API code, including endpoints, operations, input/output parameters, and authentication methods.

JOIN OUR MAILING LIST

Stay Connected with MTEC

Keep up with active and upcoming solicitations, MTEC news and other valuable information.