Raku/doc-website

Miscellaneous page lacks editable tag.

Closed this issue · 4 comments

0rir commented

/miscellaneous lacks the crayon that allows easier pull requests.

coke commented

This is a generated page, the edit tag is only for pages with direct source edits.

Might be a good idea to have the edit icon everywhere and have a pop that explains on the pages that cannot be directly edited.

  • 👍2
finanalyst commented

@0rir @coke tl;dr is it worth putting a link to editable pages? Generated pages get a popup.
Detail:
There are currently 2 sorts of pages that do not get the edit crayon:

  1. Composite pages, which are composed of segments from the Primary pages (those in the Raku/docs/ repo)
  2. Structure pages, which are in this repo. The Miscellaneous page falls into this group.

Structure pages can be edited, via a PR on this repo, so we could set things up to allow for edits.

Composite pages cannot be edited because they are generated programmatically. So a pop-up is reasonable.

I'll create a PR to generate the pop-up. But I think we could support editing of the structure pages. Thoughts?

finanalyst commented

@coke @0rir please check out how this patch works on new-raku, eg miscellaneous. Also try a composite page by using search and choosing some page.

0rir commented

@finanalyst, Looks good. FYI my response time regularly can be out to a week.