WordPress.org

Make WordPress Core

Opened 2 years ago

Closed 8 months ago

Last modified 8 months ago

#20318 closed enhancement (duplicate)

Introduce a Usage section to the Plugins API

Reported by: johnbillion Owned by:
Milestone: Priority: normal
Severity: normal Version:
Component: WordPress.org site Keywords:
Focuses: Cc:

Description

I quite often find a need for a 'Usage' section in my plugin's readme file. I usually place this within the 'Installation' section (example), but I've seen other plugins that include full usage instructions in the main description, in the FAQs, or in the 'Other Notes' section.

It would be nice if there was a top level readme section for Usage which showed up as a tab on the WordPress.org Plugin Directory.

Change History (7)

comment:1 scribu2 years ago

I think renaming "Installation" to "Usage" would be enough, since most of the times you can skip the installation steps altogether.

comment:2 dd322 years ago

I think renaming "Installation" to "Usage" would be enough

I like that, considering that most Plugins should not have any "installation" steps anymore, the ones that do (caching plugins for example) would still be able to list any custom installation procedures required in a Usage tab.

comment:3 jane2 years ago

  • Type changed from feature request to enhancement

I think Instructions or Directions would be a better label. When I first saw this ticket I thought Usage referred to how/how many people were using the plugin.

comment:4 follow-up: scribu2 years ago

"Instructions" sounds fine to me.

It would take it's content from either the == Instructions == section in readme.txt or from == Installation == to preserve back-compat for all the existing plugins.

comment:5 in reply to: ↑ 4 johnbillion2 years ago

Replying to scribu:

"Instructions" sounds fine to me.

It would take it's content from either the == Instructions == section in readme.txt or from == Installation == to preserve back-compat for all the existing plugins.

That all sounds good. +1 from me.

comment:6 samuelsidler8 months ago

  • Milestone WordPress.org deleted
  • Status changed from new to closed

Migrated to #meta123.

comment:7 SergeyBiryukov8 months ago

  • Resolution set to duplicate
Note: See TracTickets for help on using tickets.