Skip to content
This repository has been archived by the owner on Feb 9, 2022. It is now read-only.

public "metadata" in the docsearch configs? #221

Closed
phrawzty opened this issue Sep 27, 2017 · 3 comments
Closed

public "metadata" in the docsearch configs? #221

phrawzty opened this issue Sep 27, 2017 · 3 comments

Comments

@phrawzty
Copy link
Contributor

It would be useful for tracking and reporting purposes to have some fields in the configs that aren't necessarily used by the scraper. Immediately I'd like to add:

  • name: Canonical, human-readable label (such as company or project name) for a given config.
  • human_url: A URL that a human could go to and get the documentation site.
    I'm not married to those key names - suggestions welcome. 😄
@maxiloc
Copy link
Contributor

maxiloc commented Sep 27, 2017

This is already doable 😄, it's just a matter of adding them.

For name => it's what we try to do with index_name but sometimes it can be quite tricky.

@phrawzty
Copy link
Contributor Author

Following the conversation on Slack, I further propose an object tags which can contain whatever human-readable elements that may be interesting. Example:

{
	"tags": {
		"name": "Super PHP Framework 2000",
		"url": "https://human.readab.le/entrypoint#to-the-docs",
		"categories": [
			"framework",
			"php",
			"ecommerce"
		]
	}
}

@phrawzty
Copy link
Contributor Author

Concept validated. Now we figure out how to automate and scale. ;)

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants