NSubstitute icon indicating copy to clipboard operation
NSubstitute copied to clipboard

Fix doc links (#884)

Open dtchepak opened this issue 6 months ago • 1 comments

  • move /docs to /help
  • remove dates from doc names
  • move docs to sub-directories and rename to index.md so we get nice urls (e.g. help/example rather than help/example.html.
  • use wget --spider to detect and fix broken links.
  • fix search rendering. Note: dark mode does not play nicely with the GCSE input box1
  • rearrange home page to put install links at the top

dtchepak avatar Jun 09 '25 07:06 dtchepak

I propose to don't do subdirectories URLs without *.html works automatically. example: https://nsubstitute.github.io/docs/2010-02-10-replacing-return-values Looks like this is local debug server bug Make sense just remove dates because solution with index.html looks strange

@dtchepak WDYT?

Romfos avatar Jun 13 '25 20:06 Romfos

I propose to don't do subdirectories URLs without *.html works automatically. example: https://nsubstitute.github.io/docs/2010-02-10-replacing-return-values Looks like this is local debug server bug Make sense just remove dates because solution with index.html looks strange

@dtchepak WDYT?

I'm not sure about this. :thinking: It is relying on github pages specific implementation right? I kind of like being able to do python3 -m http.server 8080 -d _site and have it be representative of what the real site will look like. If you feel strongly about it though i'm happy to update this PR as suggested :+1:

dtchepak avatar Jun 22 '25 03:06 dtchepak

I propose to don't do subdirectories URLs without *.html works automatically. example: https://nsubstitute.github.io/docs/2010-02-10-replacing-return-values Looks like this is local debug server bug Make sense just remove dates because solution with index.html looks strange @dtchepak WDYT?

I'm not sure about this. 🤔 It is relying on github pages specific implementation right? I kind of like being able to do python3 -m http.server 8080 -d _site and have it be representative of what the real site will look like. If you feel strongly about it though i'm happy to update this PR as suggested 👍

If we need support other platforms then github pages - maybe this is fine

Romfos avatar Jun 22 '25 08:06 Romfos

@Romfos could you merge this pr? Would be great to see the links working again.

304NotModified avatar Jul 06 '25 13:07 304NotModified

@304NotModified I don't have merge permission. We need wait @dtchepak for feedback

Romfos avatar Jul 06 '25 15:07 Romfos

Unfortunately I also don't have merge permission

304NotModified avatar Jul 06 '25 19:07 304NotModified

@304NotModified I don't have merge permission. We need wait @dtchepak for feedback

I think I've fixed this now @304NotModified and @Romfos :crossed_fingers: Let me know if you still do not have permission.

dtchepak avatar Jul 13 '25 10:07 dtchepak

@dtchepak yes, I have it. Please deploy new version after fix

Romfos avatar Jul 13 '25 10:07 Romfos

Deployed :heavy_check_mark:

dtchepak avatar Jul 13 '25 10:07 dtchepak