apache / apache/lucenenet

Documentation Build Improvements

Open
#962 0 comments 0 reactions 0 assignees View on GitHub
docs good-first-issue is:task up-for-grabs
Dominant language
C#
Stars
2.4k
Forks
658
Avg merge
3d 5h
Merged PRs (30d)
9

Description

### Is there an existing issue for this?

- [X] I have searched the existing issues

### Task description

Broken out from feedback on #961:

- Each build adds blank lines to the end of some files; ideally this would be idempotent and would not result in pending git changes.
- Investigate if we can read the target frameworks for each subsite from a common JSON location, or worst case set it in the powershell script

Contributor guide

Open the contributing guide

Research direction

Locate the PowerShell build script and the generated documentation files or subsite configuration it uses. First reproduce a build and check for trailing blank-line changes, then inspect how target frameworks are currently supplied. Done means repeated builds are idempotent and framework targets come from a common JSON location or the script as described.

Written by the indexing model from the issue text.

Assessment

Tech stack
json, powershell
Domain
build-system, documentation
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.