Skip to content

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
    • Help
    • Submit feedback
    • Contribute to GitLab
  • Sign in
haskell-gargantext
haskell-gargantext
  • Project
    • Project
    • Details
    • Activity
    • Releases
    • Cycle Analytics
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Charts
  • Issues 175
    • Issues 175
    • List
    • Board
    • Labels
    • Milestones
  • Merge Requests 9
    • Merge Requests 9
  • CI / CD
    • CI / CD
    • Pipelines
    • Jobs
    • Schedules
    • Charts
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Charts
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
  • gargantext
  • haskell-gargantexthaskell-gargantext
  • Issues
  • #424

Closed
Open
Opened Nov 13, 2024 by Grégoire Locqueville@glocqueville
  • Report abuse
  • New issue
Report abuse New issue

Help new administrators set up `gargantext-settings.toml`

Summary

The gargantext-settings.toml must be edited for things to function properly, since some fields (typically, microservice URLs) can't be the same for all instances.

Right now, it is not obvious for new instance administrators to figure out how to go about editing the gargantext-settings.toml file to fit their situation. In particular, it is easy to accidentally leave some fields empty and get runtime errors without it being obvious what the cause is.

Help should be provided for administrators to get a correct gargantext-settings.toml file.

Steps to reproduce

  1. Be a new administrator
  2. Follow the instructions in the README: Download Gargantext, compile it, etc.
  3. Try to fill in the missing fields in gargantext-settings.toml

What is the current bug behavior?

It is not clear what the fields are for, which ones are essential and which ones can be left empty at first.

What is the expected correct behavior?

Administrators can figure out easily what data to put in front of each field, if any.

Possible fixes

I see two possible courses of action:

  • Clearly document each field in the gargantext-settings.toml file, making it clear what the administrator should put in. Fields without which the server cannot function properly are marked using a convention such as prepending the comment with REQUIRED, so that the would-be administrator can easily see if they left out something critical.
  • Or make a tool (possibly integrated with the init command) which detects if the gargantext-settings.toml file is incomplete, and if so, interactively prompts the user to enter the required fields (cabal init-style)
Assignee
Assign to
None
Milestone
None
Assign milestone
Time tracking
None
Due date
None
0
Labels
None
Assign labels
  • View project labels
Reference: gargantext/haskell-gargantext#424