search

craftcms / docs

Documentation for Craft CMS, Craft Commerce, and other official products.
https://craftcms.com/docs
39 stars 150 forks source link

Update general.md #464

Closed leevigraham closed 1 year ago

leevigraham commented 1 year ago

Fixed issue with httpproxy config docs

netlify[bot] commented 1 year ago

Deploy request for craft-docs rejected.

Name Link
Latest commit 42232c79c0a647dd4c78694e9101b161ccef615a
AugustMiller commented 1 year ago

Unfortunately, this portion of the docs is automatically generated from the Craft source code, so changes will be reverted during the next release.

I don't immediately see a solve for it over there, either—it seems like some Markdown is being parsed too early in the process, ignoring fenced code blocks.

I'll file an issue about this, to track a solution for something I fear is more widespread!

leevigraham commented 1 year ago

@AugustMiller Might be worth investigating a way to turn off "Edit this page" for content generated from source code.

AugustMiller commented 1 year ago

Aye, understood. Really, the auto-generated stuff should be entirely external to the .md files, and dynamically included by VuePress or a build step so that the source is clear about what is/isn't manually editable.

Appreciate you kickstarting the conversation!

leevigraham commented 1 year ago

@AugustMiller It was actually raised on Discord :)

image