Skip to content

Expanded the basic-porting.mdx file so it includes a tutorial on porting external libraries#552

Open
StefanAMN wants to merge 1 commit into
unikraft:mainfrom
StefanAMN:stancustefan/expand-basic-porting.mdx
Open

Expanded the basic-porting.mdx file so it includes a tutorial on porting external libraries#552
StefanAMN wants to merge 1 commit into
unikraft:mainfrom
StefanAMN:stancustefan/expand-basic-porting.mdx

Conversation

@StefanAMN
Copy link
Copy Markdown

I added a new part in the basic-porting.mdx file that includes a small guide on importing external libraries, which comes mainly from the hackathons/sessions/contributing-to-unikraft folder in an old commit, couples with some other ideas from some sessions from USoC23. This expands on the basic-porting.mdx file and integrates lessons from USoC23 regarding external C library porting.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR expands the existing “basic porting” guide to cover porting external C libraries alongside a simple application example, incorporating lessons from earlier Unikraft sessions.

Changes:

  • Updates the guide title/description to include library porting.
  • Reflows and extends the existing echo/pwd porting tutorial text.
  • Adds a new section describing external library porting concepts plus a kdtree practical exercise.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread content/guides/basic-porting.mdx Outdated
Comment thread content/guides/basic-porting.mdx Outdated
Comment thread content/guides/basic-porting.mdx Outdated
Comment thread content/guides/basic-porting.mdx Outdated
Comment thread content/guides/basic-porting.mdx Outdated
@razvand razvand self-assigned this May 2, 2026
@razvand razvand self-requested a review May 2, 2026 13:46
Copy link
Copy Markdown
Contributor

@razvand razvand left a comment

Choose a reason for hiding this comment

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

See the linter checks. In particular, use a single sentence on a line.

Do not add the library porting in the basic-porting.mdx guide. Create a new guide called library-porting.mdx. We will end up with three porting guides: basic-porting.mdx, library-porting.mdx and advanced-porting.mdx.

Add a commit body to your commit.

Prefix the commit title with feat(guides):.

@StefanAMN StefanAMN force-pushed the stancustefan/expand-basic-porting.mdx branch from 745bedd to 15d82d6 Compare May 8, 2026 18:59
@StefanAMN StefanAMN requested a review from razvand May 8, 2026 19:03
@StefanAMN StefanAMN marked this pull request as ready for review May 9, 2026 08:46
@StefanAMN StefanAMN force-pushed the stancustefan/expand-basic-porting.mdx branch 2 times, most recently from c16d1a1 to 9b75f82 Compare May 9, 2026 09:53
Copy link
Copy Markdown
Contributor

@razvand razvand left a comment

Choose a reason for hiding this comment

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

Wrap commit description lines to 72 lines.

Comment thread content/guides/basic-porting.mdx Outdated
Comment thread content/guides/basic-porting.mdx Outdated
@StefanAMN StefanAMN force-pushed the stancustefan/expand-basic-porting.mdx branch from 9b75f82 to d9e1eda Compare May 9, 2026 11:38
@StefanAMN StefanAMN requested a review from razvand May 9, 2026 11:39
Copy link
Copy Markdown
Contributor

@razvand razvand left a comment

Choose a reason for hiding this comment

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

Use Add instead of add at the start of the commit title: feat(guides): add ... should be feat(guides): Add ....

Introduce a new guide in `library-porting.mdx` explaining the process
of porting external libraries to Unikraft.

Additionally, reformat `basic-porting.mdx` and `library-porting.mdx`
to adhere to the linter's requirement of a single sentence per line.

Signed-off-by: Stefan Stancu <stefanstancu2006@gmail.com>
@StefanAMN StefanAMN force-pushed the stancustefan/expand-basic-porting.mdx branch from d9e1eda to 0a199c7 Compare May 9, 2026 19:20
@StefanAMN StefanAMN requested a review from razvand May 9, 2026 19:20
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.

3 participants