Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation to the README file #79

Open
wants to merge 5 commits into
base: github-dev
Choose a base branch
from

Conversation

Inf0Junki3
Copy link

Greetings,

Long time follower, first time contributor. Thought I would add a bit of minor documentation destined to help WriteHat newbies like me:

  • How to clear data
  • How to make use of markdown placeholders.

Given that these are not code changes, thought I would make the PR against master - but please let me know if you would prefer that I make the PR against a dev branch.

Hope this is useful!

@d4r14h
Copy link

d4r14h commented Jun 14, 2023

Trying to raise awareness for this request

@thejohnbrown
Copy link
Contributor

Just to add to this, it should be mentioned in the README that there is a button which has a list of the markdown placeholders that can be used.
image

README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
Added snippet about LDAP configuration.
@TMDeal
Copy link
Collaborator

TMDeal commented Jun 21, 2023

Ya, If you could change the pull request to be against the github-dev branch, that would probably be better. The github-dev branch is generally more up to date and actually has a fair number of additions compared to the master branch.

@thejohnbrown
Copy link
Contributor

@TMDeal Unrelated to this PR, is the github-dev branch stable enough to run in production?

@Inf0Junki3 Inf0Junki3 changed the base branch from master to github-dev June 27, 2023 21:57
README.md Outdated Show resolved Hide resolved
Documented that you can also use a different syntax for placeholders
# Path to a callable that takes a dict of {ldap_field_name: value},
# returning a list of [ldap_search_filter]. The search filters will then be AND'd
# together when creating the final search filter.
LDAP_AUTH_FORMAT_SEARCH_FILTERS = "django_python3_ldap.utils.format_search_filters"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Now that this is merging into github-dev the LDAP portion of the README should be updated to reflect additions that have been made into github-dev regarding the search filters. The changes I am referring to can be found at writehat/settings.py:76 and writehat/config/writehat.conf:46.

@TMDeal
Copy link
Collaborator

TMDeal commented Jun 29, 2023

@thejohnbrown, as of right now, the github-dev branch should be good to use for production. Given that it is being updated semi-frequently, I would recommend always being cautious when new changes are merged into it just to be on the safe side

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

Successfully merging this pull request may close these issues.

4 participants