manticoresearch icon indicating copy to clipboard operation
manticoresearch copied to clipboard

Improve settings reference in the manual

Open sanikolaev opened this issue 3 years ago • 12 comments

This is a continuation of the discussion started in this issue https://github.com/manticoresoftware/manticoresearch/issues/663#issuecomment-981323957

The task is to improve https://manual.manticoresearch.com/References , in particular different server settings.

sanikolaev avatar Dec 03 '21 17:12 sanikolaev

@benwills I've put my comments in the sheet.

sanikolaev avatar Dec 03 '21 17:12 sanikolaev

@sanikolaev I've updated the sheet using your comments.

benwills avatar Dec 13 '21 14:12 benwills

➤ Sergey Nikolaev commented:

Thank you. I'm planning to continue reviewing the doc next week.

githubmanticore avatar Dec 24 '21 10:12 githubmanticore

Hi @benwills

Sorry for the late reply. I've put my comments to the doc https://docs.google.com/spreadsheets/d/17wFUCUtA76G4GcLRPTmbNRml1rn2mg9Vy29yye9KxhU/edit#gid=0

sanikolaev avatar Jan 11 '22 06:01 sanikolaev

My turn to apologize for the late reply. I've answered and updated all of the fields in the sheet, and updated the HTML version of the table here: https://benwills.com/manticore-settings/

benwills avatar Mar 03 '22 19:03 benwills

Hi @benwills

I've commented what I could in the spreadsheet. Let's think what we can do to:

  • integrate all you've done to https://manual.manticoresearch.com/References
  • and make it more maintainable

Do you think it will work if you put it as a json (or a set of jsons) to directory "Settings" in https://github.com/manticoresoftware/manticoresearch/tree/master/manual ? Then the workflow will be:

  • once we add a new setting we'll add it to the json too
  • we'll change https://manual.manticoresearch.com/References so it's partly generated from the json (not sure yet it what format)
  • you can generate your HTML version from there too
  • if you (or anyone else) find some issue you just create a PR to update the json, we then review it, approve and merge

sanikolaev avatar Mar 17 '22 07:03 sanikolaev

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions. Feel free to re-open the issue in case it becomes actual.

stale[bot] avatar Apr 16 '22 14:04 stale[bot]

Stale, this issue is still actual, don't close it yet.

sanikolaev avatar Apr 18 '22 05:04 sanikolaev

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions. Feel free to re-open the issue in case it becomes actual.

stale[bot] avatar Jun 12 '22 18:06 stale[bot]

Let's keep it open for now.

sanikolaev avatar Jun 13 '22 06:06 sanikolaev

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions. Feel free to re-open the issue in case it becomes actual.

stale[bot] avatar Jul 31 '22 11:07 stale[bot]

Let's keep it open for now.

sanikolaev avatar Aug 01 '22 05:08 sanikolaev